Skip to main content

Symbol Order Book Ticker

Type: NONE

Weight: 1

GET /fapi/v1/ticker/bookTicker

Top-of-book — best bid and ask for one symbol.

Request

GET /fapi/v1/ticker/bookTicker?symbol=BTCUSDT

Query params

NameTypeRequiredNotes
symbolstringyesStandard pair (e.g. BTCUSDT).

Response — 200

{
"symbol": "BTCUSDT",
"bidPrice": "76520.00",
"bidQty": "0.005",
"askPrice": "76521.00",
"askQty": "0.005",
"time": 1748275200500
}
FieldNotes
bidPrice / bidQty"0" if no bids are currently on the book.
askPrice / askQty"0" if no asks are currently on the book.
timeServer timestamp at snapshot (ms).

Errors

HTTPcodemsg
400-1100Unknown symbol.
400—symbol missing or malformed: plain-text axum rejection (Failed to deserialize query string: …), not the {code,msg} JSON shape.
500-1000Matching-engine RPC unreachable.

Backed by the same matching-engine book_snapshot gRPC as depth — just takes only level 0 per side. If you need multiple levels, call depth instead.