深度信息

提供交易对深度数据查询，支持价格精度聚合和档位限制。

---

获取深度信息

获取指定交易对的深度数据，支持价格精度聚合和档位限制。

接口信息

• 方法: GET
• 路径: /api/v1/depth

请求参数

参数	位置	类型	必填	说明
symbol	query	string	是	交易对，例如 BTC_USDT
precision	query	integer	否	价格精度（小数位数），不传则返回原始精度
limit	query	integer	否	档位数量限制，默认 100，最大 5000
with_id	query	boolean	否	是否返回序列号

请求示例

GET /api/v1/depth?symbol=BTC_USDT&limit=100&with_id=true

响应字段

字段	类型	说明
code	integer	错误码，0 表示成功
message	string	错误消息
data	object	深度数据
data.symbol	string	交易对
data.asks	array	卖盘档位，格式 [[price, qty], ...]
data.bids	array	买盘档位，格式 [[price, qty], ...]
data.id	integer	序列号（with_id=true 时返回）
data.timestamp	integer	时间戳（毫秒）

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "symbol": "BTC_USDT",
    "asks": [
      ["42166.00", "0.125"],
      ["42167.00", "0.250"]
    ],
    "bids": [
      ["42165.00", "0.310"],
      ["42164.00", "0.500"]
    ],
    "id": 12345,
    "timestamp": 1768051394008
  }
}

错误响应

状态码	code	说明
400	4000	参数错误，如 symbol is required
503	-	服务不可用

{
  "code": 4000,
  "data": null,
  "message": "symbol is required"
}

---

获取同步状态

获取所有交易对的深度同步状态。

接口信息

• 方法: GET
• 路径: /api/v1/depth/status

请求参数

无

请求示例

GET /api/v1/depth/status

响应字段

字段	类型	说明
code	integer	错误码，0 表示成功
message	string	错误消息
data	object	同步状态数据
data.symbols	object	交易对同步状态映射（key 为交易对，value 为状态字符串）

响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "symbols": {
      "BTC_USDT": "synced",
      "ETH_USDT": "syncing"
    }
  }
}