深度信息

类型：NONE · 权重：5（与 limit 无关）

状态：已实现。

GET /api/v3/depth

来自撮合引擎的实时订单簿快照，最优档在前。

请求

GET /api/v3/depth?symbol=CBTC-USDCB&limit=20

Query 参数

字段	类型	必填	默认值	说明
symbol	string	是	—	如 CBTC-USDCB。
limit	integer	否	100	每侧档数。0 → 默认值；超过 5000 的值会被钳制到 5000。范围内的任意值都接受（不限于 Binance 的 5/10/20/50/100/500/1000/5000 集合）。

响应 — 200（值仅为示意）

{
  "lastUpdateId": 1756600000123,
  "bids": [
    ["59990.00", "0.2500"],
    ["59985.50", "1.0000"]
  ],
  "asks": [
    ["60010.00", "0.1200"],
    ["60012.00", "0.8000"]
  ]
}

字段	类型	说明
lastUpdateId	number	快照的毫秒时间戳（撮合引擎时钟，网关时钟作为回退）。按交易对单调递增，但不是 Binance 的 update-id 序列号——没有可用于对账的增量流。
bids[]、asks[]	[price, qty] 字符串对	买盘降序，卖盘升序。

错误

HTTP	code	触发场景
400	—	缺少 symbol（框架拒绝，纯文本响应体）。
429	-1003	按 IP 的公开权重耗尽。

如果撮合引擎无法提供快照（引擎重启中，或它不认识该交易对），端点返回的是 HTTP 200、bids 与 asks 为空并附一个新的 lastUpdateId，而不是错误。在正常有流动性的市场上收到空盘口，应视为「引擎不可用」并重试，而不是「没有流动性」。

与 Binance 的差异

• lastUpdateId 是时间戳，不是更新序列号。需要 250 ms 推送请使用 WebSocket 有限档深度流；没有可叠加在此快照之上的增量深度流。
• 权重固定为 5。