深度信息

类型：NONE

权重：5

GET /fapi/v1/depth

按 symbol 实时拉取的订单簿快照。

请求

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

Query 参数

字段	类型	必填	默认值	说明
symbol	string	是	—	标准 pair 名（如 BTCUSDT）。
limit	integer	否	50	每侧档数，从快照顶部截取。接受任意整数并钳制到 1..=100（不强制标准的固定集合 5/10/20/50/100/500/1000；大于 100 的值返回 100 档）。

响应 — 200

{
  "lastUpdateId": 1748275200500,
  "E": 1748275200500,
  "T": 1748275200500,
  "bids": [["76520.00", "0.005"], ["76519.50", "0.010"]],
  "asks": [["76521.00", "0.005"], ["76521.50", "0.010"]]
}

字段	说明
lastUpdateId / E / T	三个都填快照时刻的服务端时间戳（ms）。Rocky 尚未发布单调递增的 sequence 编号，因此不可用于增量更新重建 — 需要刷新时请重拉完整快照。

错误

HTTP	code	msg
400	-1100	未知 symbol。
400	—	symbol 或 limit 缺失或格式错误：axum 的纯文本拒绝（Failed to deserialize query string: …），不是 {code,msg} JSON 形态。
500	-1000	撮合引擎 gRPC 不可达。

Rocky 也在 Web v1 原生 surface 提供：GET /v1/markets/{symbol}/orderbook?depth=50 — 返回 Rocky 内部 symbol 形态（BTC-PERP），用 ts_ms 字段替代 lastUpdateId/E/T。