Retrieve a position record

get https://api.bridgeft.com/v2/data/source/positions/{id}

Returns a position record based on its ID

Responses

Response body

object

string

has_next

boolean

has_previous

boolean

current_page

integer

total_pages

integer

page_size_limit

integer

total_items

integer

data

object

integer

The unique resource id for the position

account_id

integer

The id of the Account associated with this Position

security_id

integer

The id of the Security associated with this Position

source_security_symbol

string

The symbol of the corresponding security as reported by the source if applicable

source_security_cusip

string

The cusip of the corresponding security as reported by the source if applicable

source

string

Custodian or source the position data comes from. APX=Apex Fintech Solutions, DST=DST Systems, FPR=Fidelity 401k/403b, IBK=Interactive Brokers, NFS=Fidelity Investments, PER=Pershing, SWB=Charles Schwab, TDA=TD Ameritrade (Available prior to Sept. 2, 2023), EGB=Eaglebrook, MLT=Millenium Trust, TIA=TIAA Financial Services

APX DST FPR IBK NFS PER SWB TDA (Available prior to Sept. 2, 2023) EGB MLT TIA

account_number

string

The account number of the Account associated with this Position

feed_code

string

The feed code of the Account associated with this Position

reported_date

date-time

The date the custodian reports the position

first_open_date

date-time

The minimum open date among all lots with known open date

direction

string

Flag to indicate if position is Long or Short. Potential values, L = Long, S = Short

L S

abs_units

float

The quantity of shares for the reported position

abs_settled_units

float

The quantity of settled shares for the reported position

abs_value

float

The market value using source-provided prices on the reported date

abs_value_lt

float

The portion of the market value that is known to belong to a long-term lot

abs_value_st

float

The portion of the market value that is known to belong to a long-term lot

abs_value_reported

float

The current market value as reported directly from the source

abs_value_unit_price_reported

float

The price as reported on source positions

abs_value_unit_price

float

Price per unit (qty) using source-provided market prices of the security

abs_cost_basis

float

The total cost basis value of the position as aggregated from reported open lots

abs_cost_basis_lt

float

The sum of the cost basis among open lots with fully known cost basis that were originated over 365 days ago

abs_cost_basis_st

float

The sum of the cost basis among open lots with fully known cost basis that were originated over within the last year

cost_basis_fully_known

boolean

True if the cost basis for all shares in this positions are fully known

unrealized_gain_loss_reported

float

The unrealized gains or losses of the position if reported by the source

unrealized_gain_loss_lt_reported

float

The portion of unrealized gain/loss known to be a long-term holding if reported by the source

unrealized_gain_loss_st_reported

float

The portion of unrealized gain/loss known to be a short-term holding if reported by the source

unrealized_gain_loss

float

The unrealized gains or losses of the position as calculated by comparing current market value to aggregated cost basis

unrealized_gain_loss_lt

float

The portion of unrealized gain/loss known to be a long-term holding.

unrealized_gain_loss_st

float

The portion of unrealized gain/loss known to be a short-term holding.

open_lots

integer

Total number of open lots reported by the source

open_lots_with_cost_basis

integer

Total number of open lots reported by the source with fully known cost basis

open_lots_lt

integer

Total number of long-term open lots reported by the source

open_lots_with_cost_basis_lt

integer

Total number of long-term open lots reported by the source with fully known cost basis

open_lots_st

integer

Total number of short-term open lots reported by the source

open_lots_with_cost_basis_st

integer

Total number of short-term open lots reported by the source with fully known cost basis

open_units

float

Total number of open units reported by the source

open_units_with_cost_basis

float

Total number of open units reported by the source with fully known cost basis

open_units_lt

float

Total number of long-term open units reported by the source

open_units_with_cost_basis_lt

float

Total number of long-term open units reported by the source with fully known cost basis

open_units_st

float

Total number of short-term open units reported by the source

open_units_with_cost_basis_st

float

Total number of short-term open units reported by the source with fully known cost basis

original_data

object

deprecated

The raw data exactly as reported by the source with original field names

Has additional fields

created_at_utc

date-time

Timestamp for when the record was created

Language

Credentials

Bearer


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.bridgeft.com/v2/data/source/positions/id \
3
     --header 'accept: application/json'

Choose an example:

application/json

200An enveloped list of positions

400Bad Request