Accounts

Manage trading accounts, balances, and portfolio history.

Get Accounts

GET/v1/accounts

Get Account By ID

GET/v1/accounts/{account_id}

Patch Account By ID

PATCH/v1/accounts/{account_id}

Get Account Balances

GET/v1/accounts/{account_id}/balances

Get Portfolio History

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

ModelsExpand Collapse

Account object { id, account_holder_entity_id, full_name, 7 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

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, 19 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.

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_total_pnl: string

Total 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.

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

Signed buying-power correction from open orders.

settled_cash: string

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

sod: AccountBalancesSod { buying_power, equity, long_market_value, 6 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

Deprecatedday_trade_buying_power: optional string

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

maintenance_margin_excess: optional string

Start-of-day maintenance margin excess. When a null/undefined value is observed, it indicates it does not apply.

maintenance_margin_requirement: optional string

Start-of-day maintenance margin requirement. 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 { day_trade_count, initial_margin_excess, initial_margin_requirement, 8 more }

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

Deprecatedday_trade_count: number

The number of day trades executed over the 5 most recent trading days.

formatint32

minimum0

initial_margin_excess: string

Initial margin excess for trade-date balances.

initial_margin_requirement: string

Initial margin requirement for trade-date balances.

intraday_details: MarginSessionDetails { buying_power, multiplier }

Intraday session margin calculation details.

buying_power: string

Maximum buying power available in the account during the session.

multiplier: optional string

Effective multiplier for margin calculations during the session.

maintenance_margin_excess: string

Maintenance margin excess for trade-date balances.

maintenance_margin_requirement: string

Maintenance margin requirement for trade-date balances.

overnight_details: MarginSessionDetails { buying_power, multiplier }

Overnight session margin calculation details.

buying_power: string

Maximum buying power available in the account during the session.

multiplier: optional string

Effective multiplier for margin calculations during the session.

Deprecatedpattern_day_trader: boolean

true if the account is currently flagged as a PDT, otherwise false.

Deprecatedday_trade_buying_power_usage: optional string

The amount of day-trade buying power used during the current trading day. When null/undefined, the value should be assumed to be zero. The field is omitted to simplify the response.

top_contributors: optional array of MarginTopContributor { day_trade_buying_power_usage, initial_margin_requirement, maintenance_margin_requirement, 2 more }

Optional top margin contributors, returned only when explicitly requested.

Deprecatedday_trade_buying_power_usage: string

Day-trade buying power consumed by fills against this underlying on the current trade date. Populated only for pattern day trader accounts.

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

Applied multiplier for margin calculations. 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, 6 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

Deprecatedday_trade_buying_power: optional string

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

maintenance_margin_excess: optional string

Start-of-day maintenance margin excess. When a null/undefined value is observed, it indicates it does not apply.

maintenance_margin_requirement: optional string

Start-of-day maintenance margin requirement. 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.

AccountList = array of Account { id, account_holder_entity_id, full_name, 7 more }

id: number

The unique identifier for the account

formatint64

account_holder_entity_id: number

The account holder entity identifier

formatint64

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"

MarginDetails object { day_trade_count, initial_margin_excess, initial_margin_requirement, 8 more }

Deprecatedday_trade_count: number

The number of day trades executed over the 5 most recent trading days.

formatint32

minimum0

initial_margin_excess: string

Initial margin excess for trade-date balances.

initial_margin_requirement: string

Initial margin requirement for trade-date balances.

intraday_details: MarginSessionDetails { buying_power, multiplier }

Intraday session margin calculation details.

buying_power: string

Maximum buying power available in the account during the session.

multiplier: optional string

Effective multiplier for margin calculations during the session.

maintenance_margin_excess: string

Maintenance margin excess for trade-date balances.

maintenance_margin_requirement: string

Maintenance margin requirement for trade-date balances.

overnight_details: MarginSessionDetails { buying_power, multiplier }

Overnight session margin calculation details.

buying_power: string

Maximum buying power available in the account during the session.

multiplier: optional string

Effective multiplier for margin calculations during the session.

Deprecatedpattern_day_trader: boolean

true if the account is currently flagged as a PDT, otherwise false.

Deprecatedday_trade_buying_power_usage: optional string

The amount of day-trade buying power used during the current trading day. When null/undefined, the value should be assumed to be zero. The field is omitted to simplify the response.

top_contributors: optional array of MarginTopContributor { day_trade_buying_power_usage, initial_margin_requirement, maintenance_margin_requirement, 2 more }

Optional top margin contributors, returned only when explicitly requested.

Deprecatedday_trade_buying_power_usage: string

Day-trade buying power consumed by fills against this underlying on the current trade date. Populated only for pattern day trader accounts.

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

Maximum buying power available in the account during the session.

multiplier: optional string

Effective multiplier for margin calculations during the session.

MarginTopContributor object { day_trade_buying_power_usage, initial_margin_requirement, maintenance_margin_requirement, 2 more }

Deprecatedday_trade_buying_power_usage: string

Day-trade buying power consumed by fills against this underlying on the current trade date. Populated only for pattern day trader accounts.

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, full_name, 7 more }

id: number

The unique identifier for the account

formatint64

account_holder_entity_id: number

The account holder entity identifier

formatint64

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: Account { id, account_holder_entity_id, full_name, 7 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

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

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, 19 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.

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_total_pnl: string

Total 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.

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

Signed buying-power correction from open orders.

settled_cash: string

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

sod: AccountBalancesSod { buying_power, equity, long_market_value, 6 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

Deprecatedday_trade_buying_power: optional string

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

maintenance_margin_excess: optional string

Start-of-day maintenance margin excess. When a null/undefined value is observed, it indicates it does not apply.

maintenance_margin_requirement: optional string

Start-of-day maintenance margin requirement. 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 { day_trade_count, initial_margin_excess, initial_margin_requirement, 8 more }

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

Deprecatedday_trade_count: number

The number of day trades executed over the 5 most recent trading days.

formatint32

minimum0

initial_margin_excess: string

Initial margin excess for trade-date balances.

initial_margin_requirement: string

Initial margin requirement for trade-date balances.

intraday_details: MarginSessionDetails { buying_power, multiplier }

Intraday session margin calculation details.

buying_power: string

Maximum buying power available in the account during the session.

multiplier: optional string

Effective multiplier for margin calculations during the session.

maintenance_margin_excess: string

Maintenance margin excess for trade-date balances.

maintenance_margin_requirement: string

Maintenance margin requirement for trade-date balances.

overnight_details: MarginSessionDetails { buying_power, multiplier }

Overnight session margin calculation details.

buying_power: string

Maximum buying power available in the account during the session.

multiplier: optional string

Effective multiplier for margin calculations during the session.

Deprecatedpattern_day_trader: boolean

true if the account is currently flagged as a PDT, otherwise false.

Deprecatedday_trade_buying_power_usage: optional string

The amount of day-trade buying power used during the current trading day. When null/undefined, the value should be assumed to be zero. The field is omitted to simplify the response.

top_contributors: optional array of MarginTopContributor { day_trade_buying_power_usage, initial_margin_requirement, maintenance_margin_requirement, 2 more }

Optional top margin contributors, returned only when explicitly requested.

Deprecatedday_trade_buying_power_usage: string

Day-trade buying power consumed by fills against this underlying on the current trade date. Populated only for pattern day trader accounts.

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

Applied multiplier for margin calculations. 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