HomeDocumentationAPI Reference
Log In
API Reference

Ticker (Instrument Name) (Interval)

Channel Name Schema

ticker.{instrument_name}.{interval}

Periodically publishes ticker info (best bid / ask, instrument contraints, fees, etc.) for a single instrument.

The 100ms ticker emits at 1s intervals if best bid / ask are not changing, otherwise emits at 100ms interval.
The 1s ticker always emits at 1s intervals.

DEPRECATION NOTICE: This publisher is deprecated in favor of ticker_slim on Dec 1, 2025.

Channel Parameters

instrument_name  string required
Instrument name

interval  string required
Interval in milliseconds
enum 100 1000

Notification Data

channel  string required
Subscribed channel name

data  object required

data. timestamp  integer required
Timestamp of the ticker feed snapshot

data. instrument_ticker  object required
Instrument of the ticker feed snapshot

data.instrument_ticker. amount_step  string required
Minimum valid increment of order amount

data.instrument_ticker. base_asset_address  string required
Blockchain address of the base asset

data.instrument_ticker. base_asset_sub_id  string required
Sub ID of the specific base asset as defined in Asset.sol

data.instrument_ticker. base_currency  string required
Underlying currency of base asset (ETH, BTC, etc)

data.instrument_ticker. base_fee  string required
$ base fee added to every taker order

data.instrument_ticker. best_ask_amount  string required
Amount of contracts / tokens available at best ask price

data.instrument_ticker. best_ask_price  string required
Best ask price

data.instrument_ticker. best_bid_amount  string required
Amount of contracts / tokens available at best bid price

data.instrument_ticker. best_bid_price  string required
Best bid price

data.instrument_ticker. erc20_details  object or null required
Details of the erc20 asset (if applicable)

data.instrument_ticker.erc20_details. decimals  integer required
Number of decimals of the underlying on-chain ERC20 token

data.instrument_ticker.erc20_details. borrow_index  string
Latest borrow index as per CashAsset.sol implementation

data.instrument_ticker.erc20_details. supply_index  string
Latest supply index as per CashAsset.sol implementation

data.instrument_ticker.erc20_details. underlying_erc20_address  string
Address of underlying on-chain ERC20 (not V2 asset)

data.instrument_ticker. fifo_min_allocation  string required
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_depth  string required
Total amount of contracts / tokens available at 5 percent above best ask price

data.instrument_ticker. five_percent_bid_depth  string required
Total amount of contracts / tokens available at 5 percent below best bid price

data.instrument_ticker. index_price  string required
Index price

data.instrument_ticker. instrument_name  string required
Instrument name

data.instrument_ticker. instrument_type  string required
erc20, option, or perp
enum erc20 option perp

data.instrument_ticker. is_active  boolean required
If True: instrument is tradeable within activation and deactivation timestamps

data.instrument_ticker. maker_fee_rate  string required
Percent of spot price fee rate for makers

data.instrument_ticker. mark_price  string required
Mark price

data.instrument_ticker. max_price  string required
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_amount  string required
Maximum valid amount of contracts / tokens per trade

data.instrument_ticker. min_price  string required
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_amount  string required
Minimum valid amount of contracts / tokens per trade

data.instrument_ticker. option_details  object or null required
Details of the option asset (if applicable)

data.instrument_ticker.option_details. expiry  integer required
Unix timestamp of expiry date (in seconds)

data.instrument_ticker.option_details. index  string required
Underlying settlement price index

data.instrument_ticker.option_details. option_type  string required
enum C P

data.instrument_ticker.option_details. strike  string required

data.instrument_ticker.option_details. settlement_price  string or null
Settlement price of the option

data.instrument_ticker. option_pricing  object or null required
Greeks, forward price, iv and mark price of the instrument (options only)

data.instrument_ticker.option_pricing. ask_iv  string required
Implied volatility of the current best ask

data.instrument_ticker.option_pricing. bid_iv  string required
Implied volatility of the current best bid

data.instrument_ticker.option_pricing. delta  string required
Delta of the option

data.instrument_ticker.option_pricing. discount_factor  string required
Discount factor used to calculate option premium

data.instrument_ticker.option_pricing. forward_price  string required
Forward price used to calculate option premium

data.instrument_ticker.option_pricing. gamma  string required
Gamma of the option

data.instrument_ticker.option_pricing. iv  string required
Implied volatility of the option

data.instrument_ticker.option_pricing. mark_price  string required
Mark price of the option

data.instrument_ticker.option_pricing. rho  string required
Rho of the option

data.instrument_ticker.option_pricing. theta  string required
Theta of the option

data.instrument_ticker.option_pricing. vega  string required
Vega of the option

data.instrument_ticker. perp_details  object or null required
Details of the perp asset (if applicable)

data.instrument_ticker.perp_details. aggregate_funding  string required
Latest aggregated funding as per PerpAsset.sol

data.instrument_ticker.perp_details. funding_rate  string required
Current hourly funding rate as per PerpAsset.sol

data.instrument_ticker.perp_details. index  string required
Underlying spot price index for funding rate

data.instrument_ticker.perp_details. max_rate_per_hour  string required
Max rate per hour as per PerpAsset.sol

data.instrument_ticker.perp_details. min_rate_per_hour  string required
Min rate per hour as per PerpAsset.sol

data.instrument_ticker.perp_details. static_interest_rate  string required
Static interest rate as per PerpAsset.sol

data.instrument_ticker. pro_rata_amount_step  string required
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_fraction  string required
Fraction of order that gets filled using pro-rata matching. If zero, the matching is full FIFO.

data.instrument_ticker. quote_currency  string required
Quote currency (USD for perps, USDC for options)

data.instrument_ticker. scheduled_activation  integer required
Timestamp at which became or will become active (if applicable)

data.instrument_ticker. scheduled_deactivation  integer required
Scheduled deactivation time for instrument (if applicable)

data.instrument_ticker. taker_fee_rate  string required
Percent of spot price fee rate for takers

data.instrument_ticker. tick_size  string required
Tick size of the instrument, i.e. minimum price increment

data.instrument_ticker. timestamp  integer required
Timestamp of the ticker feed snapshot

data.instrument_ticker. open_interest  object required
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. stats  object required
Aggregate trading stats for the last 24 hours

data.instrument_ticker.stats. contract_volume  string required
Number of contracts traded during last 24 hours

data.instrument_ticker.stats. high  string required
Highest trade price during last 24h

data.instrument_ticker.stats. low  string required
Lowest trade price during last 24h

data.instrument_ticker.stats. num_trades  string required
Number of trades during last 24h

data.instrument_ticker.stats. open_interest  string required
Current total open interest

data.instrument_ticker.stats. percent_change  string required
24-hour price change expressed as a percentage. Options: percent change in vol; Perps: percent change in mark price

data.instrument_ticker.stats. usd_change  string required
24-hour price change in USD.

data.instrument_ticker. mark_price_fee_rate_cap  string 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}