订单簿深度
获取永续合约的订单簿快照。透传 Binance USDⓈ-M 永续合约 /fapi/v1/depth。
接口
GET /fapi/v1/depth
鉴权: 公开。
查询参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
symbol | string | 是 | — | 大写永续合约符号。 |
limit | integer | 否 | 100 | 每边返回的档位数。Binance 接受 5, 10, 20, 50, 100, 500, 1000。 |
响应 — 200 OK
{
"lastUpdateId": 1234567890,
"E": 1745920800000,
"T": 1745920800000,
"bids": [
["67890.10", "1.234"],
["67890.00", "0.500"]
],
"asks": [
["67891.00", "0.800"],
["67891.10", "2.100"]
]
}
每条 bid/ask 是 [price, quantity],价量均为十进制字符串。
错误
| HTTP | 触发原因 |
|---|---|
422 | 缺少 symbol。 |
502 | 上游 Binance 请求失败。 |
示例
curl -s "https://api.pipai.org/fapi/v1/depth?symbol=BTCUSDT&limit=20"