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
| Name | Type | Required | Default | Notes |
|---|---|---|---|---|
symbol | string | yes | — | BTCUSDT (aliases accepted, see Symbols). |
limit | integer | no | 500 | 5, 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"]]
}
| Field | Notes |
|---|---|
lastUpdateId | Filled 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 / T | Event / transaction time, same value as lastUpdateId. |
bids / asks | [price, qty] strings; bids descending, asks ascending. |
Errors
| HTTP | code | msg |
|---|---|---|
400 | -1121 | Invalid symbol. |
500 | -1000 | Order book unavailable. |