Aggregated market depth
Query crypto spot and perpetual bid, ask, and two-sided order-book depth snapshots within a fixed ±2% price band.
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
Query Parameters
Provide asset_id or query
asset_idstringqueryExampleasset_btcoptionalCanonical asset identifier
querystringqueryExampleBTCoptionalSearch text used to resolve the query object
tickerstringqueryExampleBTCoptionalTicker alias of query
symbolstringqueryExampleBTCoptionalSymbol alias of query
All optional
venuestringqueryExamplebinanceoptionalOptional. 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 | perpqueryExamplespotoptionalspot or perp only; defaults to spot. Depth uses a fixed ±2% band; band_pct is not a public input
Response
Response status and resolution information
Business data availability status
countintegerReturned snapshot count, when present
limitations[]string[]Known data limitations
updated_atdatetime | stringExample2026-11-16T03:38:54ZMost recent object or response update time
partialbooleanWhether the response contains only a subset of fields
resolution_reasonstringReason code for the object-resolution outcome
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
band_pctnumberExample2Fixed price-band percentage: 2 (±2%)
depth_typestringExampleaggregated_bandmulti_venue_band for multiple venues; aggregated_band for one venue
Per-exchange depth snapshots; a venue filter also exposes the selected snapshot at the top level
bid_depth_usdnumberExample2692148.8Bid-side depth in USD
ask_depth_usdnumberExample4798456Ask-side depth in USD
two_sided_depth_usdnumberExample7490604.8Sum of bid and ask depth in USD
band_pctnumberExample2Fixed at 2 (±2%)
depth_typestringExampleaggregated_bandaggregated_band
exchangestringExampleGateExchange display name
venue_idstringExamplevenue_gateVenue identifier
snapshot_timedatetimeExample2026-11-16T02:00:00ZSource snapshot time; may differ across venues
bid_depth_usdnumberExample2692148.8Single-venue response only. Bid-side depth in USD
ask_depth_usdnumberExample4798456Single-venue response only. Ask-side depth in USD
two_sided_depth_usdnumberExample7490604.8Single-venue response only. Sum of bid and ask depth in USD
exchangestringExampleGateSingle-venue response only. Exchange display name
venue_idstringExamplevenue_gateSingle-venue response only. Venue identifier
snapshot_timedatetimeExample2026-11-16T02:00:00ZSingle-venue response only. Source snapshot time; may differ across venues
Overall availability status
request_idstringExample34a99daf-0850-4eff-8487-df8ffa2828fcRequest identifier