订单簿深度

描述

返回实时内存订单簿的按档位聚合快照。可使用 last_update_id 对后续通过 WebSocket 深度频道接收到的差分进行排序校验。

HTTP 请求

GET /spot/depth (公开 (无需鉴权))

权重

0 — 当前公开行情接口对单个 IP 不设权重限制 (MVP)。

请求参数

名称	类型	必填	描述
symbol	STRING	必填	交易对标识符（如 DFUSDT）。区分大小写。参见 GET /spot/markets。
limit	NUMBER	可选	每侧返回的档位数量。默认 50，范围 1–1000。超出范围时服务端自动截断，不返回错误。

响应示例

200 OK

{
  "symbol":         "DFUSDT",
  "last_update_id": 12345,
  "bids": [
    ["0.5000", "100"],
    ["0.4999", "200"]
  ],
  "asks": [
    ["0.5001", "150"],
    ["0.5002", "180"]
  ]
}

字段	说明
last_update_id	撮合引擎的单调递增计数器，每次订单簿变动（下单/撤单/成交）时加一。拼接 WebSocket 深度差分时用于检测数据缺口。
bids	按价格降序排列（最优买价在前）。每条记录格式为 [price, total_qty_at_level]，均为字符串。
asks	按价格升序排列（最优卖价在前）。格式同 [price, qty]。

每个档位的数量为该价位所有挂单的总和——不暴露单个订单 id。

错误响应

HTTP	error
503	spot trading disabled（服务器以 SPOT_TRADING_ENABLED=false 启动）
503	ENGINE_BUSY
503	ENGINE_RESTARTING

完整列表：错误代码。

代码示例

cURL

curl -s "https://api-sepolia.p99.world/api/v1/spot/depth?symbol=DFUSDT&limit=10"

Python

import requests

BASE = "https://api-sepolia.p99.world/api/v1"

book = requests.get(f"{BASE}/spot/depth", params={"symbol": "DFUSDT", "limit": 10}).json()
print("update_id:", book["last_update_id"])
print("best bid:", book["bids"][0] if book["bids"] else "empty")
print("best ask:", book["asks"][0] if book["asks"] else "empty")