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
- What each request returns
- 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 | nullExample64624.3Latest 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-11-16T06:48:06.024463105ZTime 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-11-16T06:48:06ZTime 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 | nullExample174.48561Absolute price change over the trailing 24 hours. Crypto only — for stocks use session_change_amount / session_change_pct
price_change_24h_percentnumber | nullExample0.27Percent price change over the trailing 24 hours. Crypto only — for stocks use session_change_pct
volume_24hnumber | nullExample840282502.4350836Cumulative 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