Skip to main content
Two channels carry fixture-related data. Subscribe to one or both depending on your use case.

​
Live Scores

Subscribe to live score updates across all active events. CHANNEL NAME fixtures:live_scores MESSAGE PAYLOAD FORMAT
NameTypeDescription
teamOneScorenumberThe current score for team one. Referring to teamOneName in the Market object
teamTwoScorenumberThe current score for team two. Referring to teamTwoName in the Market object
sportXEventIdstringThe event ID for this update
currentPeriodstringAn identifier for the current period
periodTimestringThe current time for the period. "-1" if not applicable (e.g. tennis)
sportIdnumberThe sport ID for this market
leagueIdnumberThe league ID for this market
periodsPeriod[]Individual period information
extrastringJSON-encoded extra data for this live score update
Where a Period object looks like:
NameTypeDescription
labelstringThe period name
isFinishedbooleantrue if the period is over
teamOneScorestringThe score of team one
teamTwoScorestringThe score of team two
// To subscribe
const sub = client.newSubscription("fixtures:live_scores", { positioned: true, recoverable: true });

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

sub.subscribe();
The above returns JSON structured like this: 
{
  "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": "..."
}

​
Fixture Updates

Subscribe to fixture state changes across all events (e.g. status changes, game time updates). CHANNEL NAME fixtures:global MESSAGE PAYLOAD FORMAT See the markets section for the format of the message. 
// To subscribe
const sub = client.newSubscription("fixtures:global", { positioned: true, recoverable: true });

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

sub.subscribe();