Get Orderbook

Query spread orderbook depth data.

HTTP Request

GET /v5/spread/orderbook

Request Parameters

Parameter	Required	Type	Comments
symbol	true	string	Spread combination symbol name
limit	false	integer	Limit size for each bid and ask [1, 25]. Default: 1

Response Parameters

Parameter	Type	Comments
s	string	Spread combination symbol name
b	array	Bid, buyer. Sorted by price in descending order
> b[0]	string	Bid price
> b[1]	string	Bid size
a	array	Ask, seller. Sorted by price in ascending order
> a[0]	string	Ask price
> a[1]	string	Ask size
ts	integer	The timestamp (ms) that the system generates the data
u	integer	Update ID. Is always in sequence. Corresponds to u in the 25-level WebSocket orderbook stream
seq	integer	Cross sequence
cts	integer	The timestamp from the matching engine when this orderbook data is produced. It can be correlated with T from public trade channel

Request Example

GET /v5/spread/orderbook?symbol=SOLUSDT_SOL/USDT&limit=1 HTTP/1.1
Host: api-testnet.bybit.com

Response Example

{
    "retCode": 0,
    "retMsg": "Success",
    "result": {
        "s": "SOLUSDT_SOL/USDT",
        "b": [
            [
                "21.0000",
                "0.1"
            ]
        ],
        "a": [
            [
                "23.0107",
                "4.6"
            ]
        ],
        "u": 46977,
        "ts": 1744077242177,
        "seq": 213110,
        "cts": 1744076329043
    },
    "retExtInfo": {},
    "time": 1744077243583
}