Accounts

Manage trading accounts, balances, and portfolio history.

Get Portfolio History

GET/v1/accounts/{account_id}/portfolio-history

ModelsExpand Collapse

Account object { id, account_holder_entity_id, account_holder_entity_kind, 8 more }

Represents a trading account

id: number

The unique identifier for the account

formatint64

account_holder_entity_id: number

The account holder entity identifier

formatint64

account_holder_entity_kind: AccountHolderEntityKind

Whether the account holder is a natural person or a legal entity.

One of the following:

"NATURAL_PERSON"

"LEGAL_ENTITY"

"OTHER"

full_name: string

The full legal name of the account

open_date: string

The date the account was opened

formatdate

options_level: number

The options level of the account

formatint64

short_name: string

The short name of the account

status: AccountStatus

The current status of the account

One of the following:

"ACTIVE"

"INACTIVE"

"CLOSED"

subtype: AccountSubtype

The sub-type of account

One of the following:

"CASH"

"MARGIN"

"OTHER"

type: AccountType

The type of account

One of the following:

"CUSTOMER"

"OTHER"

close_date: optional string

The date the account was closed, if applicable When a null/undefined value is observed, it indicates it does not apply.

formatdate

AccountBalances object { account_id, buying_power, currency, 18 more }

Represents the balance details for a trading account

account_id: number

The unique identifier for the account

formatint64

buying_power: string

The total buying power available in the account: base buying power plus the open order adjustment, where base buying power is maintenance margin excess times the multiplier for intraday and initial margin excess times the multiplier for overnight.

currency: string

Currency identifier for all monetary values.

daily_change: string

Difference between current equity and start-of-day equity.

daily_pnl: string

Total profit or loss since start of day.

daily_realized_pnl: string

Realized profit or loss since start of day.

daily_unrealized_pnl: string

Total unrealized profit or loss across all positions relative to prior close.

equity: string

The total equity in the account: cash plus long market value plus short market value, where short market value is negative.

long_market_value: string

The total market value of all long positions.

margin_type: MarginType

The applicable margin model for the account

One of the following:

"OTHER"

"NONE"

"PORTFOLIO_MARGIN"

"RISK_BASED_HAIRCUT_BROKER_DEALER"

"REG_T"

"RISK_BASED_HAIRCUT_MARKET_MAKER"

"CIRO"

"FUTURES_NLV"

"FUTURES_TOT_EQ"

open_order_adjustment: string

Buying power correction from open orders, computed as projected buying power minus actual buying power. A negative value means open orders are consuming buying power.

settled_cash: string

The amount of cash that is settled and available for withdrawal or trading.

sod: AccountBalancesSod { buying_power, equity, long_market_value, 5 more }

Start-of-day snapshot balances.

buying_power: string

Start-of-day buying power.

equity: string

Start-of-day equity.

long_market_value: string

Start-of-day long market value.

short_market_value: string

Start-of-day short market value.

asof: optional string

Timestamp for the start-of-day values. When a null/undefined value is observed, it indicates that there is no available data.

formatdate

maintenance_margin_excess: optional string

Start-of-day maintenance margin excess: the difference between equity and the maintenance margin requirement. When a null/undefined value is observed, it indicates it does not apply.

maintenance_margin_requirement: optional string

Start-of-day maintenance margin requirement: the amount of equity required to maintain current positions. When a null/undefined value is observed, it indicates it does not apply.

trade_cash: optional string

Start-of-day trade cash. When a null/undefined value is observed, it indicates it does not apply.

trade_cash: string

Trade-date effective cash.

unrealized_pnl: string

Total unrealized profit or loss across all open positions.

unsettled_credits: string

Trade-date unsettled cash credits.

unsettled_debits: string

Trade-date unsettled cash debits.

withdrawable_cash: string

The amount of cash currently available to withdraw.

margin_details: optional MarginDetails { initial_margin_excess, initial_margin_requirement, intraday_details, 5 more }

Margin-account-only details. When a null/undefined value is observed, it indicates it does not apply.

initial_margin_excess: string

The difference between equity and the initial margin requirement.

initial_margin_requirement: string

The amount of equity required to open new positions.

intraday_details: MarginSessionDetails { buying_power, multiplier }

Intraday session margin calculation details.

buying_power: string

Maximum buying power available in the account during the session: base buying power plus the open order adjustment, where base buying power is maintenance margin excess times the multiplier for intraday and initial margin excess times the multiplier for overnight.

multiplier: optional string

Margin multiplier for the session: 4 during intraday sessions (pre-market, regular, and after-hours) and 2 during the overnight session.

maintenance_margin_excess: string

The difference between equity and the maintenance margin requirement.

maintenance_margin_requirement: string

The amount of equity required to maintain current positions.

overnight_details: MarginSessionDetails { buying_power, multiplier }

Overnight session margin calculation details.

buying_power: string

multiplier: optional string

Margin multiplier for the session: 4 during intraday sessions (pre-market, regular, and after-hours) and 2 during the overnight session.

top_contributors: optional array of MarginTopContributor { initial_margin_requirement, maintenance_margin_requirement, market_value, underlying_instrument_id }

Optional top margin contributors, returned only when explicitly requested.

initial_margin_requirement: string

Initial margin requirement attributable to this underlying.

maintenance_margin_requirement: string

Maintenance margin requirement attributable to this underlying.

market_value: string

Net market value attributable to this underlying.

underlying_instrument_id: string

UUID of the underlying security contributing to margin requirement.

formatuuid

usage: optional MarginDetailsUsage { total, used }

Current usage totals. When a null/undefined value is observed, it indicates that there is no available data.

total: string

The total margin available in the current model.

used: string

The amount of margin that is currently being utilized.

multiplier: optional string

Margin multiplier: 4 during intraday sessions (pre-market, regular, and after-hours) and 2 during the overnight session. When a null/undefined value is observed, it indicates it does not apply.

short_market_value: optional string

The total market value of all short positions. When null/undefined, the value should be assumed to be zero. The field is omitted to simplify the response.

AccountBalancesSod object { buying_power, equity, long_market_value, 5 more }

buying_power: string

Start-of-day buying power.

equity: string

Start-of-day equity.

long_market_value: string

Start-of-day long market value.

short_market_value: string

Start-of-day short market value.

asof: optional string

Timestamp for the start-of-day values. When a null/undefined value is observed, it indicates that there is no available data.

formatdate

maintenance_margin_excess: optional string

Start-of-day maintenance margin excess: the difference between equity and the maintenance margin requirement. When a null/undefined value is observed, it indicates it does not apply.

maintenance_margin_requirement: optional string

Start-of-day maintenance margin requirement: the amount of equity required to maintain current positions. When a null/undefined value is observed, it indicates it does not apply.

trade_cash: optional string

Start-of-day trade cash. When a null/undefined value is observed, it indicates it does not apply.

AccountHolderEntityKind = "NATURAL_PERSON" or "LEGAL_ENTITY" or "OTHER"

Whether an account holder is a natural person or a legal entity.

One of the following:

"NATURAL_PERSON"

"LEGAL_ENTITY"

"OTHER"

AccountList = array of Account { id, account_holder_entity_id, account_holder_entity_kind, 8 more }

id: number

The unique identifier for the account

formatint64

account_holder_entity_id: number

The account holder entity identifier

formatint64

account_holder_entity_kind: AccountHolderEntityKind

Whether the account holder is a natural person or a legal entity.

One of the following:

"NATURAL_PERSON"

"LEGAL_ENTITY"

"OTHER"

full_name: string

The full legal name of the account

open_date: string

The date the account was opened

formatdate

options_level: number

The options level of the account

formatint64

short_name: string

The short name of the account

status: AccountStatus

The current status of the account

One of the following:

"ACTIVE"

"INACTIVE"

"CLOSED"

subtype: AccountSubtype

The sub-type of account

One of the following:

"CASH"

"MARGIN"

"OTHER"

type: AccountType

The type of account

One of the following:

"CUSTOMER"

"OTHER"

close_date: optional string

The date the account was closed, if applicable When a null/undefined value is observed, it indicates it does not apply.

formatdate

AccountSettings object { risk }

risk: optional RiskSettings { max_notional }

Risk settings for the account When a null/undefined value is observed, it indicates that there is no available data.

max_notional: optional string

The maximum notional value available to the account When a null/undefined value is observed, it indicates that there is no available data.

AccountStatus = "ACTIVE" or "INACTIVE" or "CLOSED"

Account status

One of the following:

"ACTIVE"

"INACTIVE"

"CLOSED"

AccountSubtype = "CASH" or "MARGIN" or "OTHER"

Account subtype classification providing more granular categorization

One of the following:

"CASH"

"MARGIN"

"OTHER"

AccountType = "CUSTOMER" or "OTHER"

Account type classification

One of the following:

"CUSTOMER"

"OTHER"

AccountWithPersonalDetails object { id, account_holder_entity_id, account_holder_entity_kind, 12 more }

Represents a trading account

id: number

The unique identifier for the account

formatint64

account_holder_entity_id: number

The account holder entity identifier

formatint64

account_holder_entity_kind: AccountHolderEntityKind

Whether the account holder is a natural person or a legal entity.

One of the following:

"NATURAL_PERSON"

"LEGAL_ENTITY"

"OTHER"

full_name: string

The full legal name of the account

open_date: string

The date the account was opened

formatdate

options_level: number

The options level of the account

formatint64

short_name: string

The short name of the account

status: AccountStatus

The current status of the account

One of the following:

"ACTIVE"

"INACTIVE"

"CLOSED"

subtype: AccountSubtype

The sub-type of account

One of the following:

"CASH"

"MARGIN"

"OTHER"

type: AccountType

The type of account

One of the following:

"CUSTOMER"

"OTHER"

close_date: optional string

The date the account was closed, if applicable When a null/undefined value is observed, it indicates it does not apply.

formatdate

country_of_tax_residency: optional string

The country of tax residency of the account-holder entity. null when not on file or entity reference data is unavailable. When a null/undefined value is observed, it indicates that there is no available data.

date_of_birth: optional string

The date of birth of the account holder’s primary contact. null when not on file or entity reference data is unavailable. When a null/undefined value is observed, it indicates that there is no available data.

formatdate

mailing_address: optional Address { city, country, line1, 3 more }

The mailing address of the account-holder entity. null when no mailing address is on file or entity reference data is unavailable. When a null/undefined value is observed, it indicates that there is no available data.

city: string

City

country: string

Country

line1: string

First street address line

postal_code: string

Postal code

line2: optional string

Second street address line When a null/undefined value is observed, it indicates it does not apply.

state: optional string

State or province When a null/undefined value is observed, it indicates it does not apply.

phone_number: optional string

The phone number of the account holder’s primary contact. null when not on file or entity reference data is unavailable. When a null/undefined value is observed, it indicates that there is no available data.

Address object { city, country, line1, 3 more }

A postal address.

city: string

City

country: string

Country

line1: string

First street address line

postal_code: string

Postal code

line2: optional string

Second street address line When a null/undefined value is observed, it indicates it does not apply.

state: optional string

State or province When a null/undefined value is observed, it indicates it does not apply.

MarginDetails object { initial_margin_excess, initial_margin_requirement, intraday_details, 5 more }

initial_margin_excess: string

The difference between equity and the initial margin requirement.

initial_margin_requirement: string

The amount of equity required to open new positions.

intraday_details: MarginSessionDetails { buying_power, multiplier }

Intraday session margin calculation details.

buying_power: string

multiplier: optional string

Margin multiplier for the session: 4 during intraday sessions (pre-market, regular, and after-hours) and 2 during the overnight session.

maintenance_margin_excess: string

The difference between equity and the maintenance margin requirement.

maintenance_margin_requirement: string

The amount of equity required to maintain current positions.

overnight_details: MarginSessionDetails { buying_power, multiplier }

Overnight session margin calculation details.

buying_power: string

multiplier: optional string

Margin multiplier for the session: 4 during intraday sessions (pre-market, regular, and after-hours) and 2 during the overnight session.

top_contributors: optional array of MarginTopContributor { initial_margin_requirement, maintenance_margin_requirement, market_value, underlying_instrument_id }

Optional top margin contributors, returned only when explicitly requested.

initial_margin_requirement: string

Initial margin requirement attributable to this underlying.

maintenance_margin_requirement: string

Maintenance margin requirement attributable to this underlying.

market_value: string

Net market value attributable to this underlying.

underlying_instrument_id: string

UUID of the underlying security contributing to margin requirement.

formatuuid

usage: optional MarginDetailsUsage { total, used }

Current usage totals. When a null/undefined value is observed, it indicates that there is no available data.

total: string

The total margin available in the current model.

used: string

The amount of margin that is currently being utilized.

MarginDetailsUsage object { total, used }

total: string

The total margin available in the current model.

used: string

The amount of margin that is currently being utilized.

MarginSessionDetails object { buying_power, multiplier }

buying_power: string

multiplier: optional string

Margin multiplier for the session: 4 during intraday sessions (pre-market, regular, and after-hours) and 2 during the overnight session.

MarginTopContributor object { initial_margin_requirement, maintenance_margin_requirement, market_value, underlying_instrument_id }

initial_margin_requirement: string

Initial margin requirement attributable to this underlying.

maintenance_margin_requirement: string

Maintenance margin requirement attributable to this underlying.

market_value: string

Net market value attributable to this underlying.

underlying_instrument_id: string

UUID of the underlying security contributing to margin requirement.

formatuuid

MarginType = "OTHER" or "NONE" or "PORTFOLIO_MARGIN" or 6 more

An account’s margin type

One of the following:

"OTHER"

"NONE"

"PORTFOLIO_MARGIN"

"RISK_BASED_HAIRCUT_BROKER_DEALER"

"REG_T"

"RISK_BASED_HAIRCUT_MARKET_MAKER"

"CIRO"

"FUTURES_NLV"

"FUTURES_TOT_EQ"

PortfolioHistoryResponse object { segments }

segments: array of PortfolioHistorySegment { date, eod_equity, realized_pnl, 7 more }

date: string

The date for this segment

formatdate

eod_equity: string

The equity at the end of the trading day.

realized_pnl: string

Sum of the profit and loss realized from position closing trading activity.

sod_equity: string

The equity at the start of the trading day.

unrealized_pnl: string

Sum of the profit and loss from market changes.

bought_notional: optional string

Amount bought MTM

day_pnl: optional string

Sum of the profit and loss from intraday trading activities for the trading day.

net_pnl: optional string

P&L after netting all realized and unrealized P&L, adjustments, dividends, change in accruals, income and expenses

position_pnl: optional string

P&L attributable to start-of-day (carried) positions from market movement during this trading day.

sold_notional: optional string

Amount sold MTM

PortfolioHistorySegment object { date, eod_equity, realized_pnl, 7 more }

date: string

The date for this segment

formatdate

eod_equity: string

The equity at the end of the trading day.

realized_pnl: string

Sum of the profit and loss realized from position closing trading activity.

sod_equity: string

The equity at the start of the trading day.

unrealized_pnl: string

Sum of the profit and loss from market changes.

bought_notional: optional string

Amount bought MTM

day_pnl: optional string

Sum of the profit and loss from intraday trading activities for the trading day.

net_pnl: optional string

P&L after netting all realized and unrealized P&L, adjustments, dividends, change in accruals, income and expenses

position_pnl: optional string

P&L attributable to start-of-day (carried) positions from market movement during this trading day.

sold_notional: optional string

Amount sold MTM

RiskSettings object { max_notional }

Risk settings for an account

max_notional: optional string

The maximum notional value available to the account When a null/undefined value is observed, it indicates that there is no available data.

AccountGetAccountsResponse = BaseResponse { metadata, error }

data: AccountList { id, account_holder_entity_id, account_holder_entity_kind, 8 more }

id: number

The unique identifier for the account

formatint64

account_holder_entity_id: number

The account holder entity identifier

formatint64

account_holder_entity_kind: AccountHolderEntityKind

Whether the account holder is a natural person or a legal entity.

One of the following:

"NATURAL_PERSON"

"LEGAL_ENTITY"

"OTHER"

full_name: string

The full legal name of the account

open_date: string

The date the account was opened

formatdate

options_level: number

The options level of the account

formatint64

short_name: string

The short name of the account

status: AccountStatus

The current status of the account

One of the following:

"ACTIVE"

"INACTIVE"

"CLOSED"

subtype: AccountSubtype

The sub-type of account

One of the following:

"CASH"

"MARGIN"

"OTHER"

type: AccountType

The type of account

One of the following:

"CUSTOMER"

"OTHER"

close_date: optional string

The date the account was closed, if applicable When a null/undefined value is observed, it indicates it does not apply.

formatdate

AccountGetAccountByIDResponse = BaseResponse { metadata, error }

data: AccountWithPersonalDetails { id, account_holder_entity_id, account_holder_entity_kind, 12 more }

Represents a trading account

id: number

The unique identifier for the account

formatint64

account_holder_entity_id: number

The account holder entity identifier

formatint64

account_holder_entity_kind: AccountHolderEntityKind

Whether the account holder is a natural person or a legal entity.

One of the following:

"NATURAL_PERSON"

"LEGAL_ENTITY"

"OTHER"

full_name: string

The full legal name of the account

open_date: string

The date the account was opened

formatdate

options_level: number

The options level of the account

formatint64

short_name: string

The short name of the account

status: AccountStatus

The current status of the account

One of the following:

"ACTIVE"

"INACTIVE"

"CLOSED"

subtype: AccountSubtype

The sub-type of account

One of the following:

"CASH"

"MARGIN"

"OTHER"

type: AccountType

The type of account

One of the following:

"CUSTOMER"

"OTHER"

close_date: optional string

The date the account was closed, if applicable When a null/undefined value is observed, it indicates it does not apply.

formatdate

country_of_tax_residency: optional string

date_of_birth: optional string

formatdate

mailing_address: optional Address { city, country, line1, 3 more }

city: string

City

country: string

Country

line1: string

First street address line

postal_code: string

Postal code

line2: optional string

Second street address line When a null/undefined value is observed, it indicates it does not apply.

state: optional string

State or province When a null/undefined value is observed, it indicates it does not apply.

phone_number: optional string

AccountPatchAccountByIDResponse = BaseResponse { metadata, error }

data: AccountSettings { risk }

risk: optional RiskSettings { max_notional }

Risk settings for the account When a null/undefined value is observed, it indicates that there is no available data.

max_notional: optional string

The maximum notional value available to the account When a null/undefined value is observed, it indicates that there is no available data.

AccountGetAccountBalancesResponse = BaseResponse { metadata, error }

data: AccountBalances { account_id, buying_power, currency, 18 more }

Represents the balance details for a trading account

account_id: number

The unique identifier for the account

formatint64

buying_power: string

currency: string

Currency identifier for all monetary values.

daily_change: string

Difference between current equity and start-of-day equity.

daily_pnl: string

Total profit or loss since start of day.

daily_realized_pnl: string

Realized profit or loss since start of day.

daily_unrealized_pnl: string

Total unrealized profit or loss across all positions relative to prior close.

equity: string

The total equity in the account: cash plus long market value plus short market value, where short market value is negative.

long_market_value: string

The total market value of all long positions.

margin_type: MarginType

The applicable margin model for the account

One of the following:

"OTHER"

"NONE"

"PORTFOLIO_MARGIN"

"RISK_BASED_HAIRCUT_BROKER_DEALER"

"REG_T"

"RISK_BASED_HAIRCUT_MARKET_MAKER"

"CIRO"

"FUTURES_NLV"

"FUTURES_TOT_EQ"

open_order_adjustment: string

Buying power correction from open orders, computed as projected buying power minus actual buying power. A negative value means open orders are consuming buying power.

settled_cash: string

The amount of cash that is settled and available for withdrawal or trading.

sod: AccountBalancesSod { buying_power, equity, long_market_value, 5 more }

Start-of-day snapshot balances.

buying_power: string

Start-of-day buying power.

equity: string

Start-of-day equity.

long_market_value: string

Start-of-day long market value.

short_market_value: string

Start-of-day short market value.

asof: optional string

Timestamp for the start-of-day values. When a null/undefined value is observed, it indicates that there is no available data.

formatdate

maintenance_margin_excess: optional string

Start-of-day maintenance margin excess: the difference between equity and the maintenance margin requirement. When a null/undefined value is observed, it indicates it does not apply.

maintenance_margin_requirement: optional string

Start-of-day maintenance margin requirement: the amount of equity required to maintain current positions. When a null/undefined value is observed, it indicates it does not apply.

trade_cash: optional string

Start-of-day trade cash. When a null/undefined value is observed, it indicates it does not apply.

trade_cash: string

Trade-date effective cash.

unrealized_pnl: string

Total unrealized profit or loss across all open positions.

unsettled_credits: string

Trade-date unsettled cash credits.

unsettled_debits: string

Trade-date unsettled cash debits.

withdrawable_cash: string

The amount of cash currently available to withdraw.

margin_details: optional MarginDetails { initial_margin_excess, initial_margin_requirement, intraday_details, 5 more }

Margin-account-only details. When a null/undefined value is observed, it indicates it does not apply.

initial_margin_excess: string

The difference between equity and the initial margin requirement.

initial_margin_requirement: string

The amount of equity required to open new positions.

intraday_details: MarginSessionDetails { buying_power, multiplier }

Intraday session margin calculation details.

buying_power: string

multiplier: optional string

Margin multiplier for the session: 4 during intraday sessions (pre-market, regular, and after-hours) and 2 during the overnight session.

maintenance_margin_excess: string

The difference between equity and the maintenance margin requirement.

maintenance_margin_requirement: string

The amount of equity required to maintain current positions.

overnight_details: MarginSessionDetails { buying_power, multiplier }

Overnight session margin calculation details.

buying_power: string

multiplier: optional string

Margin multiplier for the session: 4 during intraday sessions (pre-market, regular, and after-hours) and 2 during the overnight session.

top_contributors: optional array of MarginTopContributor { initial_margin_requirement, maintenance_margin_requirement, market_value, underlying_instrument_id }

Optional top margin contributors, returned only when explicitly requested.

initial_margin_requirement: string

Initial margin requirement attributable to this underlying.

maintenance_margin_requirement: string

Maintenance margin requirement attributable to this underlying.

market_value: string

Net market value attributable to this underlying.

underlying_instrument_id: string

UUID of the underlying security contributing to margin requirement.

formatuuid

usage: optional MarginDetailsUsage { total, used }

Current usage totals. When a null/undefined value is observed, it indicates that there is no available data.

total: string

The total margin available in the current model.

used: string

The amount of margin that is currently being utilized.

multiplier: optional string

Margin multiplier: 4 during intraday sessions (pre-market, regular, and after-hours) and 2 during the overnight session. When a null/undefined value is observed, it indicates it does not apply.

short_market_value: optional string

The total market value of all short positions. When null/undefined, the value should be assumed to be zero. The field is omitted to simplify the response.

AccountGetPortfolioHistoryResponse = BaseResponse { metadata, error }

data: PortfolioHistoryResponse { segments }

segments: array of PortfolioHistorySegment { date, eod_equity, realized_pnl, 7 more }

date: string

The date for this segment

formatdate

eod_equity: string

The equity at the end of the trading day.

realized_pnl: string

Sum of the profit and loss realized from position closing trading activity.

sod_equity: string

The equity at the start of the trading day.

unrealized_pnl: string

Sum of the profit and loss from market changes.

bought_notional: optional string

Amount bought MTM

day_pnl: optional string

Sum of the profit and loss from intraday trading activities for the trading day.

net_pnl: optional string

P&L after netting all realized and unrealized P&L, adjustments, dividends, change in accruals, income and expenses

position_pnl: optional string

P&L attributable to start-of-day (carried) positions from market movement during this trading day.

sold_notional: optional string

Amount sold MTM

Accounts

Get Accounts

Get Account By ID

Patch Account By ID

Get Account Balances

Get Portfolio History

ModelsExpand Collapse