跳到主要内容

Order Book

Type: NONE

Weight: 2–20 (by limit)

GET /fapi/v1/depth

Order-book snapshot for one symbol. Public endpoint: no X-MBX-APIKEY, timestamp or signature required.

Request

GET /fapi/v1/depth?symbol=BTCUSDT&limit=50

Query params

NameTypeRequiredDefaultNotes
symbolstringyesBTCUSDT (aliases accepted, see Symbols).
limitintegerno5005, 10, 20, 50, 100, 500, 1000.

Response — 200

{
"lastUpdateId": 1714261234567,
"E": 1714261234567,
"T": 1714261234567,
"bids": [["60000.50", "0.123"], ["60000.40", "0.500"]],
"asks": [["60001.00", "0.250"], ["60001.10", "0.300"]]
}
FieldNotes
lastUpdateIdFilled with the current timestamp (ms), not a monotonic update id. Do not use it for sequence-gap detection; use the orderbook: WebSocket channel for live state.
E / TEvent / transaction time, same value as lastUpdateId.
bids / asks[price, qty] strings; bids descending, asks ascending.

Errors

HTTPcodemsg
400-1121Invalid symbol.
500-1000Order book unavailable.