Skip to main content
The ticker query returns 24-hour rolling statistics for a contract: price change, high, low, volume and trade count, alongside the current funding rate, mark price, and oracle price. The window is a sliding [now − 24h, now] range, matching the conventional exchange definition — it is not a calendar day. Omit asset to retrieve every contract in one call. For a live version of the same payload, subscribe to the ticker WebSocket channel.

​
Request

​
string
required
Must be "ticker".
​
string
The contract ID as a decimal string. Omit to return every contract that has traded. Contracts that have never traded are excluded from a market-wide response, and return all-zero values when queried individually.

​
Response

​
int64
Generation time of this response — the now end of the rolling window, in Unix milliseconds.
​
array
One entry per contract. Contains a single entry when asset was supplied.

​
Ticker object fields

​
string
The contract ID this entry describes.
​
string
Most recent trade price (raw integer string, scaled by the contract’s priceScale).
​
string
Baseline price 24 hours ago — the earliest trade inside the window.
​
string
lastPx − openPx, signed (raw integer string).
​
string
Percentage change over the window, signed and carried to four decimal places (for example "1.0000" or "-0.8300"). Returns "0" when openPx is 0. This value is already a percentage — do not rescale it.
​
string
Highest trade price within the window.
​
string
Lowest trade price within the window.
​
string
Traded volume over the window, in base units (raw integer string, scaled by the contract’s qtyScale).
​
int64
Number of trades within the window.
​
int64
Start of the window in Unix milliseconds. For a contract listed less than 24 hours ago, this is the time of its earliest trade.
​
string
Current funding rate, signed, as a raw fixed-point integer with a scale of 1e8 — 1e8 represents 100%. The true rate is fundingRate / 1e8; to display a percentage, use fundingRate / 1e6. It applies per funding interval (read fundingInterval from configs). Returns "0" if the rate has never been published.
The scale is 1e8 — not basis points (1e4) and not 1e6. Example: "125" is 0.000125% per interval.
​
int64
Unix millisecond timestamp at which the current funding rate was set. Returns 0 if it has never been set.
​
string
Current mark price (raw integer string). Tracks the latest price publication regardless of trading activity, and is identical to the markPx returned by marketState. Returns "0" if never published.
​
string
Current oracle (index) price (raw integer string), from the same source as marketState. Returns "0" if never published.
Price and volume fields are raw integers — convert them with the contract’s priceScale and qtyScale from configs. Never hardcode a scale. priceChangePct is the one exception: it is already a decimal percentage.
markPx and oraclePx update with every price publication, while the OHLCV fields only move when trades occur. A contract can therefore report live prices with volume still "0".