深度

获取指定交易对的订单簿快照。

接口

GET /v1/market/depth

权重：

limit	权重
≤ 100	2
500	5
1000	10

鉴权： 公开（可选签名）。

查询参数

名称	类型	必填	说明
symbol	string	是	交易对，大写，例如 BTCUSDT。
limit	enum	否	每侧返回的价格档位数量。取值之一：5、10、20、50、100、500、1000。默认 100。

响应

{
  "lastUpdateId": 9823412115,
  "bids": [
    ["67431.90", "0.4221"],
    ["67431.80", "1.0312"],
    ["67431.50", "0.8800"],
    ["67431.10", "2.5410"],
    ["67430.90", "0.0500"]
  ],
  "asks": [
    ["67432.40", "0.3110"],
    ["67432.60", "0.7821"],
    ["67432.90", "1.4422"],
    ["67433.20", "0.2200"],
    ["67433.80", "3.1100"]
  ]
}

响应字段

字段	类型	说明
lastUpdateId	integer	该快照的单调递增更新 id。可用于将 REST 快照与 WebSocket 流对齐。
bids	array	[price, qty] 二元组数组（均为字符串）。按价格 降序 排列（最优买盘在前）。
asks	array	[price, qty] 二元组数组（均为字符串）。按价格 升序 排列（最优卖盘在前）。

快照中永远不会出现 qty 为 "0" 的档位——空档位会被省略。

错误

HTTP	错误码	含义
400	INVALID_PARAMETER	缺少 symbol，或 limit 不在允许的枚举中。
400	UNKNOWN_SYMBOL	交易对不存在。
429	RATE_LIMITED	单个 Key 的请求权重已超限。

示例

curl -s "https://api.pipai.io/v1/market/depth?symbol=BTCUSDT&limit=20"