Aggregated market depth

Query crypto spot and perpetual bid, ask, and two-sided order-book depth snapshots within a fixed ±2% price band.

GET/api/v1/markets/cex-depth
Domain
Market & Liquidity
Level
Crypto asset across venues
MCP tool
market_data_query (task=depth)

Available data

Returns
Crypto spot and perpetual bid, ask, and two-sided order-book depth snapshots within a fixed ±2% price band
Market coverage
Major crypto centralized exchanges; equities and decentralized exchanges are excluded
What each request returns
A venue filter returns one exchange; without it, the response aggregates multiple exchanges

Authentication

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

Query Parameters

Object positioning

Provide asset_id or query

asset_idstringqueryExampleasset_btcoptional

Canonical asset identifier

querystringqueryExampleBTCoptional

Search text used to resolve the query object

tickerstringqueryExampleBTCoptional

Ticker alias of query

symbolstringqueryExampleBTCoptional

Symbol alias of query

Aggregation filters

All optional

venuestringqueryExamplebinanceoptional

Optional. Pass a venue code (e.g. binance) or venue_id (e.g. venue_binance) to scope to one venue; omit to get results aggregated across venues

market_typespot | perpqueryExamplespotoptional

spot or perp only; defaults to spot. Depth uses a fixed ±2% band; band_pct is not a public input

Response

metadataobject

Response status and resolution information

data_statusDataStatusExampleready

Business data availability status

countinteger

Returned snapshot count, when present

limitations[]string[]

Known data limitations

updated_atdatetime | stringExample2026-11-16T03:38:54Z

Most recent object or response update time

partialboolean

Whether the response contains only a subset of fields

resolution_reasonstring

Reason code for the object-resolution outcome

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

band_pctnumberExample2

Fixed price-band percentage: 2 (±2%)

depth_typestringExampleaggregated_band

multi_venue_band for multiple venues; aggregated_band for one venue

venues[]array[object]

Per-exchange depth snapshots; a venue filter also exposes the selected snapshot at the top level

bid_depth_usdnumberExample2692148.8

Bid-side depth in USD

ask_depth_usdnumberExample4798456

Ask-side depth in USD

two_sided_depth_usdnumberExample7490604.8

Sum of bid and ask depth in USD

band_pctnumberExample2

Fixed at 2 (±2%)

depth_typestringExampleaggregated_band

aggregated_band

exchangestringExampleGate

Exchange display name

venue_idstringExamplevenue_gate

Venue identifier

snapshot_timedatetimeExample2026-11-16T02:00:00Z

Source snapshot time; may differ across venues

bid_depth_usdnumberExample2692148.8

Single-venue response only. Bid-side depth in USD

ask_depth_usdnumberExample4798456

Single-venue response only. Ask-side depth in USD

two_sided_depth_usdnumberExample7490604.8

Single-venue response only. Sum of bid and ask depth in USD

exchangestringExampleGate

Single-venue response only. Exchange display name

venue_idstringExamplevenue_gate

Single-venue response only. Venue identifier

snapshot_timedatetimeExample2026-11-16T02:00:00Z

Single-venue response only. Source snapshot time; may differ across venues

data_statusDataStatusExampleready

Overall availability status

request_idstringExample34a99daf-0850-4eff-8487-df8ffa2828fc

Request identifier

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.