Build with the AI Skill
Trade ItTrade ItDocs
Data Models

Asset

A stock, crypto pair, index option underlying, or futures product root. Assets are returned by asset lookup and search, and expanded on trade responses and trade webhooks.

For futures, asset.ticker names the product root, such as /MES; trade.contract selects its delivery month, such as Z26. asset.futures_details contains root-level specifications and is null for other assets and unknown products.

The futures catalog combines products available through tastytrade or TradeStation. Availability still depends on the selected brokerage and account permissions. Use Trade It roots, such as /ZN; broker-specific roots, such as TradeStation's /TY, are not accepted. Futures prices and notional exposure use futures_details.quote_currency, which can differ from the account currency.

Use GET /api/asset/<id>?contracts=true&account_id=42 to include the selected brokerage account's futures contracts and quotes. This expansion requires asset:read, brokerage:read, an owned futures-capable account, and Pro access. A plain asset lookup returns metadata without contacting a brokerage. Broker-specific symbol mappings remain internal.

For /MES, futures_details contains multiplier: 5, tick_size: 0.25, quote_currency: "USD", and contract_months: "HMUZ". These values mean one point is worth $5 per contract and one default tick is worth $1.25. An illustrative quote of 7,311 represents $36,555 of notional exposure per contract, not a margin requirement or cash payment.

tick_size is the default outright increment; contract-specific rules can differ. Listed delivery months do not determine expiration dates. Exact contract dates and quotes come from contract lookup; account-specific margin is separate.

Fields

idnumber | string

The database ID. Use for lookups.

created_atstring

When the record was created.

updated_atstringoptional

When the record last changed.

namestring | null

Company or coin name.

tickerstring

Ticker symbol.

typeenum

Asset type: 2 for stocks, 4 for crypto, 8 for indexes, 16 for futures.

024816
logo_urlstring | null

Logo image URL.

descriptionstring | null

Short description of the asset.

exchangestring

Exchange the asset trades on.

mic_codestring | null

ISO 10383 market identifier code of the exchange.

underlyingstring | null

Underlying ticker, for derivatives.

countrystring | null

Country the asset is listed in.

futures_detailsobject | null

Root-level futures specifications. Null for non-futures assets or unknown products. Contract-specific dates, quotes, and account margin are separate.

multipliernumber

Futures monetary value of a 1.00 move in the quoted price, per contract, in quote_currency. Quoted price × multiplier × contracts gives notional exposure.

tick_sizenumber

Default outright futures price increment, in quoted price units. tick_size × multiplier gives the monetary tick value per contract.

quote_currencystring

ISO 4217 currency of futures monetary values after applying multiplier, e.g. USD.

contract_monthsstring

Listed futures delivery month codes in calendar order, e.g. HMUZ for March, June, September, December.

delisted_atstring (format: date-time) | null

When the asset was delisted.

Balance

Money fields are Balance objects.

amountnumber

Amount in currency.

currencystring

ISO 4217 currency code, such as USD.

On this page