Spot. WebSocket diffs, seeded by a REST snapshot; diffs that arrive before the snapshot are buffered and replayed afterwards.
Live in productionWebSocketFull-depth diffs; REST snapshot of 1,000 levels
Live now
-
books live
-
messages / s
-
level changes / s
-
KB / s
Messages / s and KB / s are what our handler receives from the exchange (KB after decompression, REST snapshots included); level changes / s are counted after normalization, for the markets we publish.
Each diff carries U (first update ID) and u (final update ID). Buffered diffs with u <= the snapshot's lastUpdateId are dropped; live diffs with u <= the last applied ID are ignored; a diff is a gap if U > last applied u + 1.
On a gap
Only that symbol is marked unsynced: its buffer is cleared, the diff that broke the sequence is kept, a fresh REST snapshot is fetched for it and the buffered diffs are replayed - the connection stays up. On a socket error or 30 s without data we reconnect (5 s backoff, doubling) and re-fetch every snapshot.
Depth
Full-depth diffs; REST snapshot of 1,000 levels
Authentication
none
Heartbeat
We answer the server's WebSocket pings; a 30 s no-data watchdog forces a reconnect.
First connect uses the bare /ws endpoint and SUBSCRIBE messages; reconnects use a combined-stream URL listing every stream, so data flows as soon as the socket opens.
Combined-stream messages arrive wrapped as {"stream":...,"data":{...}}; both forms are accepted.
Trades share the socket with depth and are told apart by "e":"trade".
A snapshot replaces the whole book (clear, then load), which removes levels left behind by missed deletes.
Instruments
loading...
Upcoming and recent changes
2026-10-28InfoSBE documented; schema 3:3 retired 11/9/2026effective 2026-11-09May affect market data
A Simple Binary Encoding section was added. SBE schema 3:5 is current; 3:2, 3:3 and 3:4 are deprecated, and 3:3 will be retired on 2026-11-09.
Details
SBE responses were already available on the REST API without documentation. Requests for a retired schema are rejected. Retirement dates for 3:2 and 3:4 will be announced later. Our handler uses JSON, so no action is needed unless SBE is requested on the depth snapshot.
Our handler: Only matters if SBE responses are requested from the REST /api/v3/depth snapshot; the handler appears to use JSON.
2026-10-06InfoAlternative REST base endpoints api1 and api2May affect market data
https://api1.binance.us and https://api2.binance.us are now available, identical to api.binance.us in functionality and rate limits.
Details
They may offer better performance as requests pass through fewer infrastructure layers. Optionally use them as fallback hosts for the depth snapshot request if the base endpoint has issues. No action is required.
Our handler: Alternative hosts for the REST snapshot at api.binance.us/api/v3/depth that could serve as fallbacks.
2026-09-17InfolistenKey User Data Streams deprecated; sunset targeted Q4 2026
The listenKey-based User Data Stream, including listenKey connections to wss://stream.binance.us:9443, will be retired on a date to be announced, targeted for Q4 2026.
Details
Affected are POST/PUT/DELETE /api/v3/userDataStream and the WebSocket API userDataStream.start/ping/stop methods. A new userDataStream.subscribe.signature method was added to the WebSocket API. This concerns account data only, and our public streams are not affected.
Our handler: Only user data streams are affected; our depth and trade streams are public.
2026-09-01BreakingRemoval of buyer/seller order ID fields from <symbol>@tradeeffective 2026-08-31Affects our handler
The buyer order ID and seller order ID fields were removed from the <symbol>@trade stream payload as part of the 8/31/2026 upgrade.
Details
Any parser that reads the buyer order ID (b) or seller order ID (a) fields from trade messages must stop depending on them. Update the trade message schema and make parsing tolerant of their absence.
Our handler: The <symbol>@trade channel payload we consume no longer contains the buyer and seller order ID fields.
2026-09-01Action neededLocal order book guide updated; snapshot limit up to 5000effective 2026-08-31Affects our handler
The documented steps for managing a local order book were updated, with depth snapshots now referencing up to 5000 levels per side and clearer buffering and sync steps.
Details
Review the handler's snapshot-and-diff synchronization against the updated procedure. A limit of 5000 is now documented for the snapshot, whereas we use 1000.
Our handler: Affects the @depth diff stream and the REST /api/v3/depth snapshot synchronization procedure we use.