Real-time market snapshot

Query the latest price, change, volume, and order-book summary for an asset or listing.

GET/api/v1/markets/snapshot
Domain
Market & Liquidity
Level
Asset or listing
MCP tool
market_data_query (task=snapshot)

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

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Asset positioning

Provide at least one of listing_id, asset_id, query, ticker, symbol, or base

listing_idstringqueryExamplelisting_okx_BTC_USDT_spot

Canonical listing identifier

asset_idstringqueryExampleasset_btc

Canonical asset identifier

querystringqueryExampleBTC

Search text used to resolve the query object

Compatible positioning fields
tickerstringqueryExampleBTC

Ticker alias of query

symbolstringqueryExampleBTC

Symbol alias of query

basestringqueryExampleBTC

Base asset code of the trading pair

Market filters

All optional; equity queries require market

marketMarketqueryExamplecrypto

Market of the query object

venuestringqueryExampleokxoptional

Trading venue code to query

market_typeMarketTypequeryExamplespotoptional

Type of traded product

quotestringqueryExampleUSDToptional

Quote asset code of the trading pair

Response

The same endpoint returns different field sets for crypto and stocks

pricenumber | nullExample64624.3

Latest valid trade price. May be present even when data_status is partial

volumenumber | null

Cumulative traded quantity in the statistics window, in shares or coins. This is quantity, not value — see turnover for value

turnovernumber | null

Cumulative traded value in the statistics window, approximately quantity × trade price

avg_pricenumber | null

Average trade price = turnover ÷ volume. Null when either input is unavailable

bid_pricenumber | null

Best bid price at the top of the book. Stock quotes may return a null size with order_book_size_unavailable

ask_pricenumber | null

Best ask price at the top of the book. Stock quotes may return a null size with order_book_size_unavailable

best_bidnumber | null

Best bid price; same meaning as bid_price

best_asknumber | null

Best ask price; same meaning as ask_price

mid_pricenumber | null

Mid of bid/ask when both sides present: (bid + ask) / 2

spread_bpsnumber | null

Bid-ask spread in basis points relative to mid_price

listing_idstring | nullExamplelisting_gate_BTC_USDT_spot

Listing id resolved by the server. Omitted when the listing cannot be identified; treat it as unavailable rather than deriving one

venue_idstring | nullExamplevenue_gate

Trading venue id resolved by the server. Treat as unavailable when absent rather than deriving one

tickerstring

Display ticker or symbol, for example AAPL or BTC

marketMarket

Market code supported by this endpoint (crypto | us_equity | hk_equity)

snapshot_typeSnapshotType

Aggregation scope of this snapshot. Omitted for a single-listing crypto snapshot

updated_atiso8601 | nullExample2026-11-16T06:48:06.024463105Z

Time this quote or response was last updated (UTC ISO-8601)

as_of_utciso8601 | null

Time the quote occurred at the source (UTC ISO-8601). Used to compute source_delay_seconds

source_delay_secondsnumber | null

How 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 | null

Order-book snapshot time, returned separately when it differs from the last trade time

data_statusDataStatusExampleready

Availability of the business data. Check it before using any numeric field

metadataobject
data_statusDataStatusExampleready

Availability of the business data. Same values as the top-level data_status

partialboolean

True when the response is expected to be incomplete, matching data_status=partial

limitationsstring[] | null

Known 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:06Z

Time this response was assembled (UTC ISO-8601). May differ slightly from updated_at in the body

object_refs[]object[]

Unified object references

typeObjectRefTypeExampleasset

Object reference type

idstringExampleasset_btc

Canonical object identifier

entity_idstring

Canonical entity identifier

asset_idstringExampleasset_btc

Canonical asset identifier

listing_idstring

Canonical listing identifier

instrument_idstring

Canonical financial instrument identifier

venue_idstring

Canonical trading venue identifier

event_refstring

Related event identifier

market_idstring

Canonical market object identifier

venuestring

Related platform code

resolved_fromstringExampleasset_entity

Input used to resolve the object

resolution_confidencestringExampleresolved

Object 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_taskstring

Task that was actually executed

route_reasonstring

Reason the task or object was selected

empty_reasonstring

Reason code when there is no data, for example object_not_found or snapshot_expired

reasonstring

Human-readable explanation for why there is no data

next_actionstring

Suggested next step when there is no data

try_paramsobject

Echo of the query parameters used for this request, for example query and market

price_change_24hnumber | nullExample174.48561

Absolute price change over the trailing 24 hours. Crypto only — for stocks use session_change_amount / session_change_pct

price_change_24h_percentnumber | nullExample0.27

Percent price change over the trailing 24 hours. Crypto only — for stocks use session_change_pct

volume_24hnumber | nullExample840282502.4350836

Cumulative traded quantity over the trailing 24 hours. Crypto only — for stocks use volume / turnover

volume_24h_unitstring | nullExamplequote

Unit of volume_24h, for example quote-currency notional. Crypto only

venue_quotes[]object[]

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_idstring

Listing id of this quote row, resolved by the server

venue_idstring

Trading venue id of this quote row, resolved by the server

pricenumber

Latest trade price on this venue

volumenumber | null

Traded quantity on this venue

volume_24hnumber | null

Trailing 24-hour traded quantity on this venue, when available

updated_atiso8601

Quote time for this venue (UTC ISO-8601)

last_pricenumber | null

Latest trade price of the current session; same meaning as price

amplitudenumber | null

Intraday amplitude percent = (day high − day low) / previous close × 100. Null when day high/low or previous close is unavailable

open_pricenumber | null

First valid trade price of the current session

high_pricenumber | null

Highest trade price of the current session

low_pricenumber | null

Lowest trade price of the current session

prev_close_pricenumber | null

Previous trading day close, used as the baseline for change calculations

volume_rationumber | null

Current trading volume relative to its historical average. Null with volume_ratio_unavailable_live when no volume-ratio source is available

session_change_pctnumber | null

Percent change of the current session versus the previous close. Different from price_change_24h, which is a rolling 24-hour window

session_change_amountnumber | null

Absolute change amount of the current session versus the previous close

bid_volumenumber | null

Quantity available at the best bid. Usually null for stock quotes

ask_volumenumber | null

Quantity available at the best ask. Usually null for stock quotes

market_sessionMarketSession

Current trading session phase of the market

field_sourcesobject

Maps each field to the kind of source it came from, for example live:session, live:orderbook, or live:day

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.