订单簿深度

获取合约交易对的买卖盘深度数据。

接口信息

• 方法: GET
• 路径: /api/v1/futures/open-api/orderbook/{symbol}

请求参数

参数	位置	类型	必填	说明
symbol	path	string	是	合约交易对，如 BTCUSDT
depth	query	int	否	深度档位数量，默认20，最大400
with_id	query	bool	否	是否返回序列号（用于增量同步），默认false
step	query	string	否	价格聚合精度，如0.01、0.1、1

请求示例

GET /api/v1/futures/open-api/orderbook/BTCUSDT?depth=20&with_id=true

响应字段

字段	类型	说明
code	int	状态码，200 表示成功
msg	string	返回消息
data.symbol	string	合约交易对
data.bids	array	买盘，[[价格, 数量], ...]
data.asks	array	卖盘，[[价格, 数量], ...]
data.timestamp	int64	时间戳
data.id	int64	序列号（when with_id=true）

说明

• bids 买盘按价格从高到低排序
• asks 卖盘按价格从低到高排序
• id 序列号用于增量同步（需要 with_id=true）

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "symbol": "BTCUSDT",
    "bids": [
      ["68500.5", "1.25"],
      ["68500.0", "2.50"]
    ],
    "asks": [
      ["68501.0", "1.50"],
      ["68501.5", "2.00"]
    ],
    "timestamp": 1737536400000,
    "id": 12345678
  }
}