跳到主要内容

深度信息 (Order Book)

获取当前订单簿深度。

接口信息​

  • Method: GET
  • Path: /api/v1/markets/:symbol/orderbook
  • Authentication: 不需身份验证

路径参数​

参数类型必须描述
symbolstring是交易对名称（如 BTCUSDT）

查询参数​

参数类型必须描述
limitnumber否深度层数（默认 20，最大 100）

响应示例​

{
  "symbol": "BTCUSDT",
  "bids": [
    ["64999.50", "0.5000"],
    ["64999.00", "1.2000"],
    ["64998.50", "0.8000"]
  ],
  "asks": [
    ["65000.50", "0.6000"],
    ["65001.00", "1.0000"],
    ["65001.50", "0.9000"]
  ],
  "timestamp": 1704067200000
}

响应字段说明​

字段类型描述
symbolstring交易对名称
bidsarray买单列表，按价格降序排列
asksarray卖单列表，按价格升序排列
timestampnumber数据时间戳（毫秒）

价格档位格式​

每一档数据项格式: [价格, 数量]

  • 价格: 字符串格式，保证精度
  • 数量: 字符串格式，保证精度

示例解读​

["64999.50", "0.5000"]

表示在价格 64999.50 有 0.5 个 BTC 的挂单。

说明​

  • 订单簿数据来源于撮合引擎实时快照
  • 如果撮合引擎无数据，会尝试从 Redis 缓存获取
  • 买单（bids）按价格从高到低排序
  • 卖单（asks）按价格从低到高排序
  • 所有价格和数量均为字符串格式以保证精度

错误响应​

HTTP 状态码错误码描述
404INVALID_MARKET未知的交易对