Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
The migration to V3 will occur on August 25 at 10am EST. Old API integrations will stop working. See the Migrate to V3 guide →
Subscribe to real-time live scores and fixture updates
fixtures:live_scores
MESSAGE PAYLOAD FORMAT
| Name | Type | Description |
|---|---|---|
| teamOneScore | number | The current score for the home team (teamOneName in the Market object) |
| teamTwoScore | number | The current score for the away team (teamTwoName in the Market object) |
| sportXeventId | string | The event ID for this update |
| currentPeriod | string | An identifier for the current period |
| periodTime | string | The current time for the period. "-1" if not applicable (e.g. tennis) |
| sportId | number | The sport ID for this market |
| leagueId | number | The league ID for this market |
| periods | Period[] | Individual period information |
| extra | string | JSON-encoded extra data for this live score update |
Period object looks like:
| Name | Type | Description |
|---|---|---|
| label | string | The period name |
| isFinished | boolean | true if the period is over |
| teamOneScore | string | The score of team one |
| teamTwoScore | string | The score of team two |
// To subscribe
const sub = client.newSubscription("fixtures:live_scores");
sub.on("publication", (ctx) => {
const data = ctx.data;
// message handler logic
});
sub.subscribe();
import asyncio
from centrifuge import Client, PublicationContext, SubscriptionEventHandler
async def on_publication(ctx: PublicationContext) -> None:
print(ctx.data)
async def main():
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("fixtures:live_scores", handler)
await sub.subscribe()
await asyncio.Future() # keep running
asyncio.run(main())
{
"teamOneScore": 2,
"teamTwoScore": 1,
"sportXeventId": "L7178624",
"currentPeriod": "4th Set",
"periodTime": "-1",
"sportId": 6,
"leagueId": 1263,
"periods": [
{
"label": "1st Set",
"isFinished": true,
"teamOneScore": "4",
"teamTwoScore": "6"
},
{
"label": "4th Set",
"isFinished": false,
"teamOneScore": "1",
"teamTwoScore": "2"
}
],
"extra": "..."
}
fixtures:global
MESSAGE PAYLOAD FORMAT
| Name | Type | Description |
|---|---|---|
| sportXeventId | string | The event ID for this update |
| status | number | The fixture status. See fixture statuses |
// To subscribe
const sub = client.newSubscription("fixtures:global");
sub.on("publication", (ctx) => {
const data = ctx.data;
// message handler logic
});
sub.subscribe();
import asyncio
from centrifuge import Client, PublicationContext, SubscriptionEventHandler
async def on_publication(ctx: PublicationContext) -> None:
print(ctx.data)
async def main():
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("fixtures:global", handler)
await sub.subscribe()
await asyncio.Future() # keep running
asyncio.run(main())
{
"sportXeventId": "L12003787",
"status": 2
}