Real-time market snapshot
Query the latest price, change, volume, and order-book summary for an asset or listing.
Available data
- Returns
- The latest price, change, volume, and order-book summary for an asset or listing
- Market coverage
- Crypto and US and Hong Kong equities
- Query granularity
- One asset per query; a listing identifier narrows the result to one venue listing
Authentication
Query Parameters
Provide at least one of listing_id, asset_id, query, ticker, symbol, or base.
listing_idstringqueryExamplelisting_okx_BTC_USDT_spotCanonical listing identifier
asset_idstringqueryExampleasset_btcCanonical asset identifier
querystringqueryExampleBTCSearch text used to resolve the query object
tickerstringqueryExampleBTCTicker alias of query.
symbolstringqueryExampleBTCSymbol alias of query.
basestringqueryExampleBTCBase asset code of the trading pair
All optional; equity queries require market.
Market of the query object
venuestringqueryExampleokxoptionalTrading venue code to query
Type of traded product
quotestringqueryExampleUSDToptionalQuote asset code of the trading pair
Response
The same endpoint returns different field sets for crypto and stocks
pricenumber | nullExample64079.8Latest valid trade price. May be present even when data_status is partial.
volumenumber | nullCumulative traded quantity in the statistics window, in shares or coins. This is quantity, not value — see turnover for value.
turnovernumber | nullCumulative traded value in the statistics window, approximately quantity × trade price.
avg_pricenumber | nullAverage trade price = turnover ÷ volume. Null when either input is unavailable.
bid_pricenumber | nullBest bid price at the top of the book. Stock quotes may return a null size with order_book_size_unavailable.
ask_pricenumber | nullBest ask price at the top of the book. Stock quotes may return a null size with order_book_size_unavailable.
best_bidnumber | nullBest bid price; same meaning as bid_price.
best_asknumber | nullBest ask price; same meaning as ask_price.
mid_pricenumber | nullMid of bid/ask when both sides present: (bid + ask) / 2.
spread_bpsnumber | nullBid-ask spread in basis points relative to mid_price.
listing_idstring | nullExamplelisting_gate_BTC_USDT_spotListing id resolved by the server. Omitted when the listing cannot be identified; treat it as unavailable rather than deriving one.
venue_idstring | nullExamplevenue_gateTrading venue id resolved by the server. Treat as unavailable when absent rather than deriving one.
tickerstringDisplay ticker or symbol, for example AAPL or BTC.
marketMarketMarket code supported by this endpoint (crypto | us_equity | hk_equity).
snapshot_typeSnapshotTypeAggregation scope of this snapshot. Omitted for a single-listing crypto snapshot.
updated_atiso8601 | nullExample2026-08-17T17:07:11.560722597ZTime this quote or response was last updated (UTC ISO-8601).
as_of_utciso8601 | nullTime the quote occurred at the source (UTC ISO-8601). Used to compute source_delay_seconds.
source_delay_secondsnumber | nullHow stale the quote is, in seconds (now − as_of_utc/updated_at). Within regular trading hours, a delay above the threshold sets data_status to stale and adds quote_source_latency_high to limitations.
snapshot_timeiso8601 | nullOrder-book snapshot time, returned separately when it differs from the last trade time.
Availability of the business data. Check it before using any numeric field.
Availability of the business data. Same values as the top-level data_status.
partialbooleanTrue when the response is expected to be incomplete, matching data_status=partial.
limitationsstring[] | nullKnown data limitations for this response, for example order_book_size_unavailable, volume_ratio_unavailable_live, quote_source_latency_high, or snapshot_stale.
missing_fieldsstring[]Names of fields known to be missing, for example price_change_24h, volume_24h, bid_size.
updated_atiso8601 | nullExample2026-08-17T17:07:11ZTime this response was assembled (UTC ISO-8601). May differ slightly from updated_at in the body.
Unified object references
Object reference type
idstringExampleasset_btcCanonical object identifier
entity_idstringCanonical entity identifier
asset_idstringExampleasset_btcCanonical asset identifier
listing_idstringCanonical listing identifier
instrument_idstringCanonical financial instrument identifier
venue_idstringCanonical trading venue identifier
event_refstringRelated event identifier
market_idstringCanonical market object identifier
venuestringRelated platform code
resolved_fromstringExampleasset_entityInput used to resolve the object
resolution_confidencestringExampleresolvedObject resolution confidence
limitations includes listing_id_unavailable_source_code_onlystring (limitation token)The listing could not be identified, so object_refs may be empty while a price is still returned.
actual_taskstringTask that was actually executed
route_reasonstringReason the task or object was selected
empty_reasonstringReason code when there is no data, for example object_not_found or snapshot_expired.
reasonstringHuman-readable explanation for why there is no data.
next_actionstringSuggested next step when there is no data.
try_paramsobjectEcho of the query parameters used for this request, for example query and market.
price_change_24hnumber | nullExample813.8134600000001Absolute price change over the trailing 24 hours. Crypto only — for stocks use session_change_amount / session_change_pct.
price_change_24h_absolutenumber | nullExample813.8134600000001Absolute price change over the trailing 24 hours. Crypto only.
price_change_24h_percentnumber | nullExample1.27Percent price change over the trailing 24 hours. Crypto only — for stocks use session_change_pct.
volume_24hnumber | nullExample263668502.3634611Cumulative traded quantity over the trailing 24 hours. Crypto only — for stocks use volume / turnover.
volume_24h_unitstring | nullExamplequoteUnit of volume_24h, for example quote-currency notional. Crypto only.
Per-venue quote rows. Omitted for a single-listing crypto snapshot; for stocks it appears only when the listing or venue can be identified.
listing_idstringListing id of this quote row, resolved by the server
venue_idstringTrading venue id of this quote row, resolved by the server
pricenumberLatest trade price on this venue
volumenumber | nullTraded quantity on this venue
volume_24hnumber | nullTrailing 24-hour traded quantity on this venue, when available
updated_atiso8601Quote time for this venue (UTC ISO-8601)
last_pricenumber | nullLatest trade price of the current session; same meaning as price.
amplitudenumber | nullIntraday amplitude percent = (day high − day low) / previous close × 100. Null when day high/low or previous close is unavailable.
open_pricenumber | nullFirst valid trade price of the current session.
high_pricenumber | nullHighest trade price of the current session.
low_pricenumber | nullLowest trade price of the current session.
prev_close_pricenumber | nullPrevious trading day close, used as the baseline for change calculations.
volume_rationumber | nullCurrent trading volume relative to its historical average. Null with volume_ratio_unavailable_live when no volume-ratio source is available.
session_change_pctnumber | nullPercent change of the current session versus the previous close. Different from price_change_24h, which is a rolling 24-hour window.
session_change_amountnumber | nullAbsolute change amount of the current session versus the previous close.
bid_volumenumber | nullQuantity available at the best bid. Usually null for stock quotes.
ask_volumenumber | nullQuantity available at the best ask. Usually null for stock quotes.
market_sessionMarketSessionCurrent trading session phase of the market.
field_sourcesobjectMaps each field to the kind of source it came from, for example live:session, live:orderbook, or live:day.