Event Order Book Updates

Subscribe to order book changes for every market on a single event. The payloads are identical to orderbook_v3:{marketHash}, including marketHash — this channel exists so that watching a whole event costs one channel instead of one per market. This namespace keeps the last 100 publications for 5 minutes, so pass recoverable: true to recover missed messages on reconnect. If a gap comes back recovered: false, re-seed every market on the event from GET /orderbook-v3/snapshot — which carries the same version — rather than trusting the books you held. There is no per-event snapshot route, so re-seed each market individually. CHANNEL NAME FORMAT orderbook_v3_event:{eventId}

Name	Type	Description
eventId	string	The event to subscribe to. Receives updates for all markets under this event. The same identifier markets report as `sportXeventId`

MESSAGE PAYLOAD FORMAT Identical to orderbook_v3:{marketHash}, including the version field. version is per market, so key your state by marketHash and apply a publication only when its version is strictly greater than the one you hold for that market — see book versioning.

// To subscribe
const eventId = "L12003787";
const sub = client.newSubscription(`orderbook_v3_event:${eventId}`, { recoverable: true });

sub.on("publication", (ctx) => {
  const data = ctx.data;
  // message handler logic — key state by data.marketHash
});

sub.subscribe();

import asyncio
from centrifuge import Client, PublicationContext, SubscriptionEventHandler

async def on_publication(ctx: PublicationContext) -> None:
    print(ctx.data)

async def main():
    event_id = "L12003787"
    client = Client(
        "wss://realtime.sx.bet/connection/websocket",
        token="YOUR_TOKEN",  # from /user/realtime-token-v3/api-key
    )
    await client.connect()
    handler = SubscriptionEventHandler(on_publication=on_publication)
    sub = client.new_subscription(f"orderbook_v3_event:{event_id}", handler)
    await sub.subscribe()
    await asyncio.Future()  # keep running

asyncio.run(main())

The above returns JSON structured like this:

{
  "marketHash": "0xbf06c6379c922d8118612d1d7493b20f6df6929437fbf6022904327f9516a2eb",
  "version": "00100000000000010015000",
  "outcomeOne": [{ "percentageOdds": "40000000000000000000", "size": "1000000" }],
  "outcomeTwo": []
}

Last modified on August 11, 2026

Overview

Metadata

Sports Data

Markets

Wallet & Funding

Utilities

Order Book

Orders

Trades, Fills & Positions

Public Channels

Account Channels