Order Book (深度)

獲取深度數據

覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權

• 期貨: 最多返回500檔的數據.
• 現貨: 最多返回200檔的數據.
• 期權: 僅返回25檔的數據.

提示

響應是當前時間的切片數據

HTTP請求

GET /v5/market/orderbook

請求參數

參數	是否必需	類型	說明
category	true	string	產品類型. spot, linear, inverse, option
symbol	true	string	合約名稱
limit	false	integer	深度限制. spot: [1, 200], 默認: 1. linear&inverse: [1, 500],默認: 25. option: [1, 25],默認: 1.

響應參數

參數	類型	說明
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推送裡的500檔的u對齊 對於現貨, 它和wss推送裡的200檔的u對齊
seq	integer	撮合版本號 該字段可以用於關聯不同檔位的orderbook, 如果值越小, 則說明數據生成越早 期權目前不存在此字段

---

請求示例

HTTP

GET /v5/market/orderbook?category=spot&symbol=BTCUSDT HTTP/1.1
Host: api-testnet.bybit.com

Python

from pybit.unified_trading import HTTP
session = HTTP(testnet=True)
print(session.get_orderbook(
    category="linear",
    symbol="BTCUSDT",
))

Java

import com.bybit.api.client.domain.CategoryType;
import com.bybit.api.client.domain.market.*;
import com.bybit.api.client.domain.market.request.MarketDataRequest;
import com.bybit.api.client.service.BybitApiClientFactory;
var client = BybitApiClientFactory.newInstance().newAsyncMarketDataRestClient();
var orderbookRequest = MarketDataRequest.builder().category(CategoryType.SPOT).symbol("BTCUSDT").build();
client.getMarketOrderBook(orderbookRequest,System.out::println);

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
    testnet: true,
});

client
    .getOrderbook({
        category: 'linear',
        symbol: 'BTCUSDT',
    })
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "s": "BTCUSDT",
        "b": [
            [
                "62710.2",
                "5.52"
            ]
        ],
        "a": [
            [
                "62710.3",
                "0.01"
            ]
        ],
        "ts": 1709199771584,
        "u": 243781,
        "seq": 3887177875
    },
    "retExtInfo": {},
    "time": 1709199771643
}