Endpoint B3 — Order Book

GET /api/v1/fdata/depth

返回指定合约的订单簿深度，默认深度 100 档（买卖各 50）。

Request Parameters

参数	类型	必填	说明
symbol	string	必填	合约标识，格式 \{BASE\}-USD-PERP，如 ETH-USD-PERP
limit	integer	可选	深度档数，默认 100

Response Fields

字段名	类型	必填	描述
ticker_id	string	必填	合约标识，与请求 symbol 一致
timestamp	Integer (UTC ms)	必填	订单簿最后更新时间戳
bids	float64[][]	必填	买单数组，每项 [价格, 数量]，按价格从高到低排列
asks	float64[][]	必填	卖单数组，每项 [价格, 数量]，按价格从低到高排列

Request Example

GET /api/v1/fdata/depth?symbol=BTC-USD-PERP&limit=10

Response Example

{
  "ticker_id": "BTC-USD-PERP",
  "timestamp": 1743091200000,
  "bids": [
    [65418.00, 0.263],
    [65415.50, 0.184],
    [65410.00, 0.441]
    // ... 最多 limit 档
  ],
  "asks": [
    [65422.00, 0.105],
    [65425.00, 0.273],
    [65430.50, 0.158]
    // ... 最多 limit 档
  ]
}