# Asset

Source: https://docs.tradeit.app/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 [#fields]

**`id`** `number | string`

The database ID. Use for lookups.

**`created_at`** `string`

When the record was created.

**`updated_at`** `string` `optional`

When the record last changed.

**`name`** `string | null`

Company or coin name.

**`ticker`** `string`

Ticker symbol.

**`type`** `enum`

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

`0``2``4``8``16`

**`logo_url`** `string | null`

Logo image URL.

**`description`** `string | null`

Short description of the asset.

**`exchange`** `string`

Exchange the asset trades on.

**`mic_code`** `string | null`

ISO 10383 market identifier code of the exchange.

**`underlying`** `string | null`

Underlying ticker, for derivatives.

**`country`** `string | null`

Country the asset is listed in.

**`futures_details`** `object | null`

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

> **`multiplier`** `number`
> 
> 
> 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_size`** `number`
> 
> 
> Default outright futures price increment, in quoted price units. tick_size × multiplier gives the monetary tick value per contract.
> 
> 
> **`quote_currency`** `string`
> 
> 
> ISO 4217 currency of futures monetary values after applying multiplier, e.g. USD.
> 
> 
> **`contract_months`** `string`
> 
> 
> Listed futures delivery month codes in calendar order, e.g. HMUZ for March, June, September, December.

**`delisted_at`** `string (format: date-time) | null`

When the asset was delisted.

## Balance [#balance]

Money fields are Balance objects.

**`amount`** `number`

Amount in `currency`.

**`currency`** `string`

ISO 4217 currency code, such as `USD`.
