HomeDocumentationAPI Reference
Log In
API Reference

Ticker (Instrument Name) (Interval)

Channel Name Schema

ticker.{instrument_name}.{interval}

DEPRECATED SINCE DECEMBER 1, 2025 IN FAVOR OF TICKER_SLIM

Channel Parameters

instrument_namestringrequired
Instrument name
intervalstringrequired
Interval in milliseconds
enum 1001000

Notification Data

channelstringrequired
Subscribed channel name
dataobjectrequired
data.timestampintegerrequired
Timestamp of the ticker feed snapshot
data.instrument_tickerobjectrequired
Instrument of the ticker feed snapshot
data.instrument_ticker.amount_stepstringrequired
Minimum valid increment of order amount
data.instrument_ticker.base_asset_addressstringrequired
Blockchain address of the base asset
data.instrument_ticker.base_asset_sub_idstringrequired
Sub ID of the specific base asset as defined in Asset.sol
data.instrument_ticker.base_currencystringrequired
Underlying currency of base asset (ETH, BTC, etc)
data.instrument_ticker.base_feestringrequired
$ base fee added to every taker order
data.instrument_ticker.best_ask_amountstringrequired
Amount of contracts / tokens available at best ask price
data.instrument_ticker.best_ask_pricestringrequired
Best ask price
data.instrument_ticker.best_bid_amountstringrequired
Amount of contracts / tokens available at best bid price
data.instrument_ticker.best_bid_pricestringrequired
Best bid price
data.instrument_ticker.erc20_detailsobject or nullrequired
Details of the erc20 asset (if applicable)
data.instrument_ticker.erc20_details.decimalsintegerrequired
Number of decimals of the underlying on-chain ERC20 token
data.instrument_ticker.erc20_details.borrow_indexstring
Latest borrow index as per CashAsset.sol implementation
data.instrument_ticker.erc20_details.supply_indexstring
Latest supply index as per CashAsset.sol implementation
data.instrument_ticker.erc20_details.underlying_erc20_addressstring
Address of underlying on-chain ERC20 (not V2 asset)
data.instrument_ticker.fifo_min_allocationstringrequired
Minimum number of contracts that get filled using FIFO. Actual number of contracts that gets filled by FIFO will be the max between this value and (1 - pro_rata_fraction) x order_amount, plus any size leftovers due to rounding.
data.instrument_ticker.five_percent_ask_depthstringrequired
Total amount of contracts / tokens available at 5 percent above best ask price
data.instrument_ticker.five_percent_bid_depthstringrequired
Total amount of contracts / tokens available at 5 percent below best bid price
data.instrument_ticker.index_pricestringrequired
Index price
data.instrument_ticker.instrument_namestringrequired
Instrument name
data.instrument_ticker.instrument_typestringrequired
erc20, option, or perp
enum erc20optionperp
data.instrument_ticker.is_activebooleanrequired
If True: instrument is tradeable within activation and deactivation timestamps
data.instrument_ticker.maker_fee_ratestringrequired
Percent of spot price fee rate for makers
data.instrument_ticker.mark_pricestringrequired
Mark price
data.instrument_ticker.max_pricestringrequired
Maximum price at which an agressive buyer can be matched. Any portion of a market order that would execute above this price will be cancelled. A limit buy order with limit price above this value is treated as post only (i.e. it will be rejected if it would cross any existing resting order).
data.instrument_ticker.maximum_amountstringrequired
Maximum valid amount of contracts / tokens per trade
data.instrument_ticker.min_pricestringrequired
Minimum price at which an agressive seller can be matched. Any portion of a market order that would execute below this price will be cancelled. A limit sell order with limit price below this value is treated as post only (i.e. it will be rejected if it would cross any existing resting order).
data.instrument_ticker.minimum_amountstringrequired
Minimum valid amount of contracts / tokens per trade
data.instrument_ticker.option_detailsobject or nullrequired
Details of the option asset (if applicable)
data.instrument_ticker.option_details.expiryintegerrequired
Unix timestamp of expiry date (in seconds)
data.instrument_ticker.option_details.indexstringrequired
Underlying settlement price index
data.instrument_ticker.option_details.option_typestringrequired
enum CP
data.instrument_ticker.option_details.strikestringrequired
data.instrument_ticker.option_details.settlement_pricestring or null
Settlement price of the option
data.instrument_ticker.option_pricingobject or nullrequired
Greeks, forward price, iv and mark price of the instrument (options only)
data.instrument_ticker.option_pricing.ask_ivstringrequired
Implied volatility of the current best ask
data.instrument_ticker.option_pricing.bid_ivstringrequired
Implied volatility of the current best bid
data.instrument_ticker.option_pricing.deltastringrequired
Delta of the option
data.instrument_ticker.option_pricing.discount_factorstringrequired
Discount factor used to calculate option premium
data.instrument_ticker.option_pricing.forward_pricestringrequired
Forward price used to calculate option premium
data.instrument_ticker.option_pricing.gammastringrequired
Gamma of the option
data.instrument_ticker.option_pricing.ivstringrequired
Implied volatility of the option
data.instrument_ticker.option_pricing.mark_pricestringrequired
Mark price of the option
data.instrument_ticker.option_pricing.rhostringrequired
Rho of the option
data.instrument_ticker.option_pricing.thetastringrequired
Theta of the option
data.instrument_ticker.option_pricing.vegastringrequired
Vega of the option
data.instrument_ticker.perp_detailsobject or nullrequired
Details of the perp asset (if applicable)
data.instrument_ticker.perp_details.aggregate_fundingstringrequired
Latest aggregated funding as per PerpAsset.sol
data.instrument_ticker.perp_details.funding_ratestringrequired
Current hourly funding rate as per PerpAsset.sol
data.instrument_ticker.perp_details.indexstringrequired
Underlying spot price index for funding rate
data.instrument_ticker.perp_details.max_rate_per_hourstringrequired
Max rate per hour as per PerpAsset.sol
data.instrument_ticker.perp_details.min_rate_per_hourstringrequired
Min rate per hour as per PerpAsset.sol
data.instrument_ticker.perp_details.static_interest_ratestringrequired
Static interest rate as per PerpAsset.sol
data.instrument_ticker.pro_rata_amount_stepstringrequired
Pro-rata fill share of every order is rounded down to be a multiple of this number. Leftovers of the order due to rounding are filled FIFO.
data.instrument_ticker.pro_rata_fractionstringrequired
Fraction of order that gets filled using pro-rata matching. If zero, the matching is full FIFO.
data.instrument_ticker.quote_currencystringrequired
Quote currency (USD for perps, USDC for options)
data.instrument_ticker.scheduled_activationintegerrequired
Timestamp at which became or will become active (if applicable)
data.instrument_ticker.scheduled_deactivationintegerrequired
Scheduled deactivation time for instrument (if applicable)
data.instrument_ticker.taker_fee_ratestringrequired
Percent of spot price fee rate for takers
data.instrument_ticker.tick_sizestringrequired
Tick size of the instrument, i.e. minimum price increment
data.instrument_ticker.timestampintegerrequired
Timestamp of the ticker feed snapshot
data.instrument_ticker.open_interestobjectrequired
Margin type of subaccount (PM (Portfolio Margin), PM2 (Portfolio Margin 2), or SM (Standard Margin)) -> (current open interest, open interest cap, manager currency)
data.instrument_ticker.mark_price_fee_rate_capstring or null
Percent of option price fee cap, e.g. 12.5%, null if not applicable

Example

Subscriptions are only available via websockets.

{request_example_javascript}
{request_example_python}

Notification messages on this channel will look like this:

{response_example_json}