API Reference

V1

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Accounts

Manage trading accounts, balances, and portfolio history.

Get Accounts

AccountGetAccountsResponse v1().accounts().getAccounts(AccountGetAccountsParamsparams = AccountGetAccountsParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

GET/v1/accounts

Get Account By ID

AccountGetAccountByIdResponse v1().accounts().getAccountById(AccountGetAccountByIdParamsparams = AccountGetAccountByIdParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

GET/v1/accounts/{account_id}

Patch Account By ID

AccountPatchAccountByIdResponse v1().accounts().patchAccountById(AccountPatchAccountByIdParamsparams = AccountPatchAccountByIdParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

PATCH/v1/accounts/{account_id}

Get Account Balances

AccountGetAccountBalancesResponse v1().accounts().getAccountBalances(AccountGetAccountBalancesParamsparams = AccountGetAccountBalancesParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

GET/v1/accounts/{account_id}/balances

Get Portfolio History

AccountGetPortfolioHistoryResponse v1().accounts().getPortfolioHistory(AccountGetPortfolioHistoryParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

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

List non-trade activities

AccountGetNonTradeActivitiesResponse v1().accounts().getNonTradeActivities(AccountGetNonTradeActivitiesParamsparams = AccountGetNonTradeActivitiesParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

GET/v1/accounts/{account_id}/non-trade-activities

ModelsExpand Collapse

class Account:

Represents a trading account

long id

The unique identifier for the account

formatint64

long accountHolderEntityId

The account holder entity identifier

formatint64

AccountHolderEntityKind accountHolderEntityKind

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

One of the following:

NATURAL_PERSON("NATURAL_PERSON")

LEGAL_ENTITY("LEGAL_ENTITY")

OTHER("OTHER")

String fullName

The full legal name of the account

LocalDate openDate

The date the account was opened

formatdate

long optionsLevel

The options level of the account

formatint64

String shortName

The short name of the account

AccountStatus status

The current status of the account

One of the following:

ACTIVE("ACTIVE")

INACTIVE("INACTIVE")

CLOSED("CLOSED")

AccountSubtype subtype

The sub-type of account

One of the following:

CASH("CASH")

MARGIN("MARGIN")

OTHER("OTHER")

AccountType type

The type of account

One of the following:

CUSTOMER("CUSTOMER")

OTHER("OTHER")

Optional<LocalDate> closeDate

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

formatdate

class AccountBalances:

Represents the balance details for a trading account

long accountId

The unique identifier for the account

formatint64

String buyingPower

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 overnight margin excess times the multiplier for overnight.

String currency

Currency identifier for all monetary values.

MarginSession currentSession

The session whose values the engine is applying to these balances. buying_power, multiplier, and margin_details.usage reflect this session. A closed market reports overnight.

One of the following:

INTRADAY("intraday")

OVERNIGHT("overnight")

String dailyChange

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

String dailyPnl

Total profit or loss since start of day.

String dailyRealizedPnl

Realized profit or loss since start of day.

String dailyUnrealizedPnl

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

String equity

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

String longMarketValue

The total market value of all long positions.

MarginType marginType

The applicable margin model for the account

One of the following:

OTHER("OTHER")

NONE("NONE")

PORTFOLIO_MARGIN("PORTFOLIO_MARGIN")

RISK_BASED_HAIRCUT_BROKER_DEALER("RISK_BASED_HAIRCUT_BROKER_DEALER")

REG_T("REG_T")

RISK_BASED_HAIRCUT_MARKET_MAKER("RISK_BASED_HAIRCUT_MARKET_MAKER")

CIRO("CIRO")

FUTURES_NLV("FUTURES_NLV")

FUTURES_TOT_EQ("FUTURES_TOT_EQ")

String openOrderAdjustment

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.

String settledCash

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

AccountBalancesSod sod

Start-of-day snapshot balances.

String buyingPower

Start-of-day buying power.

String equity

Start-of-day equity.

String longMarketValue

Start-of-day long market value.

String shortMarketValue

Start-of-day short market value.

Optional<LocalDate> asof

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

formatdate

Optional<String> maintenanceMarginExcess

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.

Optional<String> maintenanceMarginRequirement

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.

Optional<String> tradeCash

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

String tradeCash

Trade-date effective cash.

String unrealizedPnl

Total unrealized profit or loss across all open positions.

String unsettledCredits

Trade-date unsettled cash credits.

String unsettledDebits

Trade-date unsettled cash debits.

String withdrawableCash

The amount of cash currently available to withdraw.

Optional<MarginDetails> marginDetails

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

String initialMarginExcess

The difference between equity and the initial margin requirement.

String initialMarginRequirement

The amount of equity required to open new positions.

MarginSessionDetails intradayDetails

Intraday session margin calculation details.

String buyingPower

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 overnight margin excess times the multiplier for overnight.

Optional<String> multiplier

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

String maintenanceMarginExcess

The difference between equity and the maintenance margin requirement.

String maintenanceMarginRequirement

The amount of equity required to maintain current positions.

MarginSessionDetails overnightDetails

Overnight session margin calculation details.

String buyingPower

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 overnight margin excess times the multiplier for overnight.

Optional<String> multiplier

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

String overnightMarginExcess

The difference between equity and the overnight margin requirement.

String overnightMarginRequirement

The amount of equity required to hold current positions overnight.

Optional<List<MarginTopContributor>> topContributors

Optional top margin contributors, returned only when explicitly requested.

String initialMarginRequirement

Initial margin requirement attributable to this underlying.

String maintenanceMarginRequirement

Maintenance margin requirement attributable to this underlying.

String marketValue

Net market value attributable to this underlying.

String overnightMarginRequirement

Overnight margin requirement attributable to this underlying.

String underlyingInstrumentId

UUID of the underlying security contributing to margin requirement.

formatuuid

Optional<MarginDetailsUsage> usage

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

String total

The total margin available in the current model.

String used

The amount of margin that is currently being utilized.

Optional<String> multiplier

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.

Optional<String> shortMarketValue

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.

Optional<AccountBalancesSma> sma

The intraday special memorandum account (SMA) of the account holder. Omitted when no SMA is available for the current trade date, or when the account holder has more than one open account. When a null/undefined value is observed, it indicates that there is no available data.

LocalDateTime asof

The time the SMA was calculated as of (UTC). During a trade date the API returns the last published value, so use this time to judge how current the value is.

formatdate-time

String value

The SMA amount in the account currency. The value can be negative.

class AccountBalancesSma:

The intraday special memorandum account (SMA) of an account holder.

The SMA belongs to the account holder, not to one account. The API returns it only when the account holder has a single open account.

LocalDateTime asof

The time the SMA was calculated as of (UTC). During a trade date the API returns the last published value, so use this time to judge how current the value is.

formatdate-time

String value

The SMA amount in the account currency. The value can be negative.

class AccountBalancesSod:

String buyingPower

Start-of-day buying power.

String equity

Start-of-day equity.

String longMarketValue

Start-of-day long market value.

String shortMarketValue

Start-of-day short market value.

Optional<LocalDate> asof

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

formatdate

Optional<String> maintenanceMarginExcess

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.

Optional<String> maintenanceMarginRequirement

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.

Optional<String> tradeCash

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

enum AccountHolderEntityKind:

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

NATURAL_PERSON("NATURAL_PERSON")

LEGAL_ENTITY("LEGAL_ENTITY")

OTHER("OTHER")

class AccountSettings:

Optional<RiskSettings> risk

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

Optional<String> maxNotional

The maximum notional value available to the account. On update, a value must be 0 or greater, null clears the limit, and omitting the field leaves the limit unchanged. When a null/undefined value is observed, it indicates that there is no available data.

enum AccountStatus:

Account status

ACTIVE("ACTIVE")

INACTIVE("INACTIVE")

CLOSED("CLOSED")

enum AccountSubtype:

Account subtype classification providing more granular categorization

CASH("CASH")

MARGIN("MARGIN")

OTHER("OTHER")

enum AccountType:

Account type classification

CUSTOMER("CUSTOMER")

OTHER("OTHER")

class AccountWithPersonalDetails:

Represents a trading account

long id

The unique identifier for the account

formatint64

long accountHolderEntityId

The account holder entity identifier

formatint64

AccountHolderEntityKind accountHolderEntityKind

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

One of the following:

NATURAL_PERSON("NATURAL_PERSON")

LEGAL_ENTITY("LEGAL_ENTITY")

OTHER("OTHER")

String fullName

The full legal name of the account

LocalDate openDate

The date the account was opened

formatdate

long optionsLevel

The options level of the account

formatint64

String shortName

The short name of the account

AccountStatus status

The current status of the account

One of the following:

ACTIVE("ACTIVE")

INACTIVE("INACTIVE")

CLOSED("CLOSED")

AccountSubtype subtype

The sub-type of account

One of the following:

CASH("CASH")

MARGIN("MARGIN")

OTHER("OTHER")

AccountType type

The type of account

One of the following:

CUSTOMER("CUSTOMER")

OTHER("OTHER")

Optional<LocalDate> closeDate

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

formatdate

Optional<String> countryOfTaxResidency

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.

Optional<LocalDate> dateOfBirth

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

Optional<Address> mailingAddress

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.

String city

City

String country

Country

String line1

First street address line

String postalCode

Postal code

Optional<String> line2

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

Optional<String> state

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

Optional<String> phoneNumber

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.

enum ActivityState:

The states exposed by this endpoint.

SETTLED("settled")

CANCELLED("cancelled")

enum ActivityType:

Type of an activity.

MONEY_MOVEMENT("money_movement")

INTEREST("interest")

FEE("fee")

DIVIDEND("dividend")

OPTION_EVENT("option_event")

TRANSFER("transfer")

CORPORATE_ACTION("corporate_action")

TAX_WITHHOLDING("tax_withholding")

ADJUSTMENT("adjustment")

OTHER("other")

class Address:

A postal address.

String city

City

String country

Country

String line1

First street address line

String postalCode

Postal code

Optional<String> line2

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

Optional<String> state

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

class MarginDetails:

String initialMarginExcess

The difference between equity and the initial margin requirement.

String initialMarginRequirement

The amount of equity required to open new positions.

MarginSessionDetails intradayDetails

Intraday session margin calculation details.

String buyingPower

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 overnight margin excess times the multiplier for overnight.

Optional<String> multiplier

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

String maintenanceMarginExcess

The difference between equity and the maintenance margin requirement.

String maintenanceMarginRequirement

The amount of equity required to maintain current positions.

MarginSessionDetails overnightDetails

Overnight session margin calculation details.

String buyingPower

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 overnight margin excess times the multiplier for overnight.

Optional<String> multiplier

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

String overnightMarginExcess

The difference between equity and the overnight margin requirement.

String overnightMarginRequirement

The amount of equity required to hold current positions overnight.

Optional<List<MarginTopContributor>> topContributors

Optional top margin contributors, returned only when explicitly requested.

String initialMarginRequirement

Initial margin requirement attributable to this underlying.

String maintenanceMarginRequirement

Maintenance margin requirement attributable to this underlying.

String marketValue

Net market value attributable to this underlying.

String overnightMarginRequirement

Overnight margin requirement attributable to this underlying.

String underlyingInstrumentId

UUID of the underlying security contributing to margin requirement.

formatuuid

Optional<MarginDetailsUsage> usage

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

String total

The total margin available in the current model.

String used

The amount of margin that is currently being utilized.

class MarginDetailsUsage:

String total

The total margin available in the current model.

String used

The amount of margin that is currently being utilized.

enum MarginSession:

The margin session applied to an account’s balances.

INTRADAY("intraday")

OVERNIGHT("overnight")

class MarginSessionDetails:

String buyingPower

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 overnight margin excess times the multiplier for overnight.

Optional<String> multiplier

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

class MarginTopContributor:

String initialMarginRequirement

Initial margin requirement attributable to this underlying.

String maintenanceMarginRequirement

Maintenance margin requirement attributable to this underlying.

String marketValue

Net market value attributable to this underlying.

String overnightMarginRequirement

Overnight margin requirement attributable to this underlying.

String underlyingInstrumentId

UUID of the underlying security contributing to margin requirement.

formatuuid

enum MarginType:

An account’s margin type

OTHER("OTHER")

NONE("NONE")

PORTFOLIO_MARGIN("PORTFOLIO_MARGIN")

RISK_BASED_HAIRCUT_BROKER_DEALER("RISK_BASED_HAIRCUT_BROKER_DEALER")

REG_T("REG_T")

RISK_BASED_HAIRCUT_MARKET_MAKER("RISK_BASED_HAIRCUT_MARKET_MAKER")

CIRO("CIRO")

FUTURES_NLV("FUTURES_NLV")

FUTURES_TOT_EQ("FUTURES_TOT_EQ")

class NonTradeActivity:

String id

ID for the activity, in UUID-v7 format.

formatuuid

String accountId

Account ID

String activitySubtype

Subtype within its activity_type.

ActivityType activityType

Categorization for the activity.

One of the following:

MONEY_MOVEMENT("money_movement")

INTEREST("interest")

FEE("fee")

DIVIDEND("dividend")

OPTION_EVENT("option_event")

TRANSFER("transfer")

CORPORATE_ACTION("corporate_action")

TAX_WITHHOLDING("tax_withholding")

ADJUSTMENT("adjustment")

OTHER("other")

String amount

Cash amount change.

LocalDateTime createdAt

The creation time at UTC, when this activity became part of the ledger

formatdate-time

String currency

Currency of the cash amount. Always USD for now.

LocalDate effectiveDate

Effective date for the activity

formatdate

SecurityType instrumentType

The security type.

One of the following:

COMMON_STOCK("COMMON_STOCK")

INDEX("INDEX")

OPTION("OPTION")

CASH("CASH")

String memo

Memo

String qty

Quantity change in the instrument.

ActivityState state

State for this activity.

One of the following:

SETTLED("settled")

CANCELLED("cancelled")

Optional<String> cancelledReferenceId

Reference ID for the record that is being cancelled. Present only on records where the activity state is ‘cancelled’. The contents of this fields points at the reference_id of the original record that is being cancelled by this record.

Optional<String> instrumentId

Instrument identifier. Omitted when the activity has no single resolvable instrument.

formatuuid

Optional<String> referenceId

Reference ID for the activity, in ULID format. Present only on records where activity state is ‘settled’. When a activity is cancelled, the cancelation record is pointing at this reference_id.

Optional<String> symbol

Symbol of the instrument. Omitted when the activity has no single resolvable instrument.

class PortfolioHistoryResponse:

List<PortfolioHistorySegment> segments

LocalDate date

The date for this segment

formatdate

String eodEquity

The equity at the end of the trading day.

String realizedPnl

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

String sodEquity

The equity at the start of the trading day.

String unrealizedPnl

Sum of the profit and loss from market changes.

Optional<String> boughtNotional

Amount bought MTM

Optional<String> dayPnl

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

Optional<String> netPnl

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

Optional<String> positionPnl

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

Optional<String> soldNotional

Amount sold MTM

class PortfolioHistorySegment:

LocalDate date

The date for this segment

formatdate

String eodEquity

The equity at the end of the trading day.

String realizedPnl

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

String sodEquity

The equity at the start of the trading day.

String unrealizedPnl

Sum of the profit and loss from market changes.

Optional<String> boughtNotional

Amount bought MTM

Optional<String> dayPnl

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

Optional<String> netPnl

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

Optional<String> positionPnl

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

Optional<String> soldNotional

Amount sold MTM

class RiskSettings:

Risk settings for an account

Optional<String> maxNotional

The maximum notional value available to the account. On update, a value must be 0 or greater, null clears the limit, and omitting the field leaves the limit unchanged. When a null/undefined value is observed, it indicates that there is no available data.