Bitget books

messagebooksBitget WebSocket APIWebSocketPublic channels

Order book depth for one symbol. The topic chooses the depth: books for every level, books1 for 1, books5 for 5 and books50 for 50. books and books50 send a snapshot first and then incremental updates, while books1 and books5 send a snapshot every time.

Risk warning: CFDs and spread bets are complex instruments and come with a high risk of losing money rapidly due to leverage. You can lose money on these products, and each provider publishes its own loss figure under FCA rules. You should consider whether you understand how they work and whether you can afford to take the high risk of losing your money. Automated and API trading can amplify losses through bugs, connectivity failures and runaway orders.

Independent and unofficialbitget.comchecked 12 Oct 2026

This is a subscription of the Bitget WebSocket API, not an HTTP endpoint. It has no method and no path: it is sent as JSON over an open WebSocket connection.

The page gives the push frequency as 1 ms for books1, 10 ms for books5, 20 ms for books50 and 50 ms for books, for spot and for futures. It says the seq of one update must equal the pseq of the next, and that after a release or restart the numbers can be reset, in which case a message with pseq 0 is likely.

The message

Name: books
Direction: Subscription, opened by the client and then fed by the server
Subscribed to as: books
Carried by: WebSocket. This channel is in the public section of Bitget's WebSocket documentation. The addresses are the ones on Bitget's quick start page (bitget.com/docs/uta/quick-start), opened the same day, which also lists VIP and low latency hosts.
Public channel: wss://ws.bitget.com/v3/ws/public
Public channel, demo trading: wss://wspap.bitget.com/v3/ws/public

Fields

Name	Type	Description
oprequired	String	subscribe to start the channel, unsubscribe to stop it.
argsrequired	List<Object>	The channels to act on. Each entry names one.
args[].instTyperequired	String	The product type: spot, usdt-futures, coin-futures or usdc-futures.
args[].topicrequired	String	books, books1, books5 or books50.
args[].symbolrequired	String	The symbol, for example BTCUSDT.

What arrives

books: A message with the event subscribe and the same arg confirms the subscription, with a connId for the connection. On an error the event is error, with a code and a msg. Data then arrives as below.

The vendor's page does not say which of these fields are required or always present.

Name	Type	Description
arg	Object	The channel the data belongs to: the instType, the topic and, on a public channel, the symbol that were subscribed to.
action	String	snapshot for a full push, update for an incremental one.
ts	String	The time of the push.
data	List<Object>	The depth data.
data[].a	List<String>	The asks, in ascending order of price. Each entry holds a price and a quantity.
data[].b	List<String>	The bids, in descending order of price. Each entry holds a price and a quantity.
data[].seq	String	A serial number that rises when the order book is updated. It shows whether messages arrived out of order.
data[].pseq	String	The serial number of the previous push, which shows whether a message was lost. It has a value on books and books50 only.
data[].maxDepth	String	The most levels the symbol has, from 0 to 1000. It has a value on books only.
data[].ts	String	When the data was generated, as Unix time in milliseconds.

Sample

Written by this site from the fields recorded on this page. It has not been run against a terminal, a server or an account, and the values in it are placeholders. No credential is typed into it: where a field holds one, the placeholder says where it comes from. Nothing is entered on this site.

{
  "op": "subscribe",
  "args": [
    {
      "instType": "usdt-futures",
      "topic": "books",
      "symbol": "BTCUSDT"
    }
  ]
}

Limits that apply at Bitget

Limit	Value	Scope	Source
Public market data, legacy v1 API	20 per 2 s per IP, public market data	Per IP address, public market data endpoints of the legacy v1 API	bitgetlimited.github.iochecked 12 Oct 2026
Overall requests a minute	6,000	Per IP address, all requests to the common domain name, with REST and WebSocket sharing one allowance	bitget.comchecked 12 Oct 2026
Concurrent WebSocket connections	100	Per IP address	bitget.comchecked 12 Oct 2026
WebSocket messages a second	10	Per WebSocket connection, counting ping, login, subscribe and unsubscribe messages	bitget.comchecked 12 Oct 2026
WebSocket subscription requests an hour	240	Per WebSocket connection	bitget.comchecked 12 Oct 2026
Concurrent WebSocket channel subscriptions	1,000	Per WebSocket connection	bitget.comchecked 12 Oct 2026