当前最优挂单
类型:NONE
权重:1
GET /fapi/v1/ticker/bookTicker
最优挂单 — 单 symbol 的最佳买价和卖价。
请求
GET /fapi/v1/ticker/bookTicker?symbol=BTCUSDT
Query 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 是 | 标准 pair(如 BTCUSDT)。 |
响应 — 200
{
"symbol": "BTCUSDT",
"bidPrice": "76520.00",
"bidQty": "0.005",
"askPrice": "76521.00",
"askQty": "0.005",
"time": 1748275200500
}
| 字段 | 说明 |
|---|---|
bidPrice / bidQty | 当前订单簿无 bid 时返回 "0"。 |
askPrice / askQty | 当前订单簿无 ask 时返回 "0"。 |
time | 快照时刻的服务器时间戳(ms)。 |
错误
| HTTP | code | msg |
|---|---|---|
400 | -1100 | 未知 symbol。 |
400 | — | symbol 缺失或格式错误:axum 的纯文本拒绝(Failed to deserialize query string: …),不是 {code,msg} JSON 形态。 |
500 | -1000 | 撮合引擎 gRPC 不可达。 |
底层走与 depth 相同的撮合引擎
book_snapshotgRPC,只取每侧的第 0 档。需要多档时请直接用 depth。