全深度訂單簿
獲取全深度訂單簿數據
覆蓋範圍: 現貨 / USDT永續 / USDC永續 / 反向合約
- 每側最多返回 10,000 檔數據。
信息
- 響應為切片（snapshot）格式。
- 請使用此 REST 接口初始化本地訂單簿，再通過 WebSocket 全深度訂單簿 應用增量更新。
- 零售價格優化（RPI）訂單不會包含在響應中。
上線時間表
| 產品 | 測試網 | 主網 |
|---|---|---|
| 現貨 | ✅ | ✅ |
| 期貨（線性 & 反向） | 2026年8月4日 | 2026年8月11日 |
HTTP請求
GET/v5/market/full_orderbook請求參數
| 參數 | 是否必需 | 類型 | 說明 |
|---|---|---|---|
| category | true | string | 產品類型. spot, linear, inverse |
| symbol | true | string | 合約名稱, 例如 BTCUSDT |
響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
| s | string | 合約名稱 |
| b | array | Bid, 買方. 按照價格從大到小 |
| > b[0] | string | 買方報價 |
| > b[1] | string | 買方數量 |
| a | array | Ask, 賣方. 按照價格從小到大 |
| > a[0] | string | 賣方報價 |
| > a[1] | string | 賣方數量 |
| ts | integer | 行情服務生成數據時間戳（毫秒） |
| u | integer | 表示數據連續性的id, 它和wss全深度訂單簿的u對齊 |
| seq | integer | 撮合版本號
|
| cts | integer | 產生此訂單簿數據時來自撮合引擎的時間戳. 可用於與平台成交頻道中的T進行關聯 |
請求示例
- HTTP
- Python
- Go
- Node.js
GET /v5/market/full_orderbook?category=spot&symbol=BTCUSDT HTTP/1.1
Host: api-testnet.bybit.com
響應示例
```json
{"retCode":0,"retMsg":"OK","result":{"s":"BTCUSDT","a":[["62998.2","0.198738"],["62998.3","0.088547"],["62998.4","0.293984"],["62998.5","0.161343"],["62998.6","0.161342"],
["62998.7","0.088547"],["62998.8","0.088547"],["62998.9","0.065597"],["63086.1","0.004041"],...
["198857.1","2303.920815"],["199700.1","0.12"],["200000","0.00961"],["200999","0.1"],
["202510.2","2303.920815"],["206163.2","2303.920815"],["209816.3","2303.920815"],
["213228.9","0.026903"],["213469.3","2303.920815"],["217122.4","2303.920815"],["220775.5","2303.920815"],
["224428.5","2303.920815"],["228081.6","2303.920815"],["231734.6","2303.920815"],["234551.8","0.024213"],
["235387.7","2303.920815"],["239040.8","2303.920815"],["242693.8","2303.920815"],["246346.9","2303.920815"],
["250000","2303.920815"],["336808","0.002"],["899900","0.03"],["900000","0.01"],["901350","0.001"],["911182.1","0.003733"],
["1111111","9.79063"],["10000000","0.003"],["980070546.6","0.000225"],["999999999","4.785"],["10000000000","0.0001"]],
"b":[["62998.1","0.396837"],["62998","0.396838"],["62997.9","0.293985"],["62997.8","0.161342"],["62997.7","0.119525"],
["62997.6","0.088547"],["62997.5","0.065597"],["62996.7","0.0993"],["62984","19.76866"],...["1999.6","0.058786"],
["1870.9","1"],["1800","1.01"],["1600","1.666666"],["1268.1","0.02"],["1073.7","1"],["1033","0.503388"],["1000","18.864945"],
["833.3","0.012"],["831.4","0.012028"],["630","10"],["530","1"],["500","5.457686"],["419.9","0.024763"],["350","1"],
["111","0.001"],["100","11.5101"],["90","1"],["85.6","4"],["78","7"],["50","1.03"],["30","0.0005"],["28.9","0.093461"],
["25","0.001"],["21","1"],["10","6.621391"],["8","7"],["5","7.621"],["4.2","1.19"],["4.1","2.38"],["2","12.52"],["1","241.879901"],
["0.4","10"],["0.1","10"]],"ts":1784103578352,"u":439925,"seq":2164890076,"cts":1784103578350},"retExtInfo":{},"time":1784103579732}