Live order book

Query current bid and ask levels, best prices, and the mid-price for a trading object.

GET/api/v1/markets/order-book/current

Domain

Market & Liquidity

Level

Listing

MCP tool

market_data_query (task=orderbook)

Available data

Returns: Current bid and ask levels, best prices, and the mid-price for a trading object
Market coverage: Crypto and US and Hong Kong equities; equities return top-of-book only
Query granularity: One listing per query; crypto may return multiple depth levels, while equity sizes may be unavailable

Authentication

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

Query Parameters

Object positioning

Provide at least one of listing_id, asset_id, query, or base.

listing_idstringqueryExamplelisting_gate_BTC_USDT_spotconditional

Canonical listing identifier

asset_idstringqueryExampleasset_btcconditional

Canonical asset identifier

querystringqueryExampleBTCconditional

Search text used to resolve the query object

tickerstringqueryExampleBTCconditional

Ticker alias of query.

symbolstringqueryExampleBTCconditional

Symbol alias of query.

basestringqueryExampleBTCconditional

Base asset code of the trading pair

Market routing

Equities require market; crypto defaults to gate / spot / USDT.

marketMarketqueryExamplecryptoconditional

Market of the query object

venuestringqueryExamplegateoptional

Trading venue code to query

market_typeMarketTypequeryExamplespotoptional

Type of traded product

quotestringqueryExampleUSDToptional

Quote asset code of the trading pair

Response control

All optional.

depthintegerqueryExample20optional

Number of order-book levels requested

Response

best_bidnumberExample64079.8

Current highest bid price

best_asknumberExample64079.9

Current lowest ask price

mid_pricenumberExample64079.850000000006

Midpoint of the best bid and best ask

spread_bpsnumberExample0.01560552966315383

Bid-ask spread in basis points

bids[]array[[string, string]]

Bid order-book levels

asks[]array[[string, string]]

Ask order-book levels

snapshot_timedatetimeExample2026-08-17T17:07:12.671404874Z

Source snapshot time for the order book

data_statusDataStatusExampleready

Availability of the business data

metadataobject

Response status and resolution information

data_statusDataStatusExampleready

Availability of the business data

actual_taskstring

Task that was actually executed

route_reasonstring

Reason the task or object was selected

limitations[]string[]

Known data limitations

updated_atdatetime | stringExample2026-08-17T17:07:12Z

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

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.