Skip to main content

​
What it streams

Metadata for a given fixtureId — including match status, start times, participants, and tournament/sport info. Also includes optional scores and mapped provider IDs. This is the anchor stream used to map odds/scores to a real-world fixture.

​
Routing

  • Entity key: payload.fixtureId
  • Filters: sportIds, tournamentIds, fixtureIds
  • Access: live/pregame determined by your apiKey

​
Payload fields

FieldTypeDescription
fixtureIdstringUnique ID of the fixture
statusobjectMatch status info
status.livebooleanTrue if currently live
status.statusIdnumber | nullOptional status code
status.statusNamestring | nullStatus name (e.g. “Live”, “Postponed”)
sportobjectSport metadata
sport.sportIdnumberUnique sport ID
sport.sportNamestringSport name
tournamentobjectTournament metadata
tournament.tournamentIdnumberUnique tournament ID
tournament.tournamentNamestringTournament name
tournament.categoryNamestringGeographic/organizational category
seasonobjectSeason metadata
season.seasonIdnumber | nullSeason ID (nullable)
season.seasonNamestring | nullSeason name
startTimenumberScheduled start (epoch seconds UTC)
trueStartTimestring | nullActual start time (ISO 8601)
trueEndTimestring | nullActual end time (ISO 8601)
participantsobjectCompetitor metadata
participants.participant1IdnumberTeam/player 1 ID
participants.participant1NamestringTeam/player 1 name
participants.participant1Abbrstring | nullOptional abbreviation
participants.participant1RotNrnumber | nullOptional rotation number
participants.participant2IdnumberTeam/player 2 ID
participants.participant2NamestringTeam/player 2 name
participants.participant2Abbrstring | nullOptional abbreviation
participants.participant2RotNrnumber | nullOptional rotation number
scoresobjectOptional score object (same format as scores stream)
expectedPeriodsnumber | nullNumber of scheduled periods (e.g. halves/sets/quarters)
periodLengthnumber | nullPeriod duration in minutes
externalProvidersobjectMapped provider IDs
externalProviders.betradarIdnumber | nullBetradar fixture ID
externalProviders.flashscoreIdstring | nullFlashscore ID
externalProviders.pinnacleIdnumber | nullPinnacle fixture ID
externalProviders.sofascoreIdnumber | nullSofascore ID
externalProviders.oddinIdnumber | nullOddin ID
externalProviders.mollybetIdstring | nullMollybet ID
externalProviders.opticoddsIdstring | nullOpticodds ID
externalProviders.lsportsIdnumber | nullLSports ID
externalProviders.txoddsIdnumber | nullTXOdds ID

​
Example message (JSON)

{
  "channel": "fixtures",
  "type": "UPDATE",
  "payload": {
    "fixtureId": "id1000046363014481",
    "status": {
      "live": true,
      "statusId": 1,
      "statusName": "Live"
    },
    "sport": {
      "sportId": 10,
      "sportName": "Soccer"
    },
    "tournament": {
      "tournamentId": 463,
      "tournamentName": "AFC Champions League Elite",
      "categoryName": "International Clubs"
    },
    "season": {
      "seasonId": 131657,
      "seasonName": "AFC Champions League Elite 25/26"
    },
    "startTime": 1766427300,
    "trueStartTime": "2025-12-22T18:15:38.441757+00:00",
    "trueEndTime": null,
    "participants": {
      "participant1Id": 61532,
      "participant1RotNr": null,
      "participant1Name": "Al Shorta SC",
      "participant1Abbr": null,
      "participant2Id": 34469,
      "participant2RotNr": null,
      "participant2Name": "Al Ahli Saudi FC",
      "participant2Abbr": null
    },
    "scores": {},
    "expectedPeriods": null,
    "periodLength": null,
    "externalProviders": {
      "betgeniusId": 12860147,
      "betradarId": 63014481,
      "flashscoreId": "hUsabPpR",
      "mollybetId": "2025-12-22,29690,26898",
      "oddinId": null,
      "opticoddsId": "20251222AF56C9CD",
      "pinnacleId": 1621307620,
      "sofascoreId": 14466133,
      "lsportsId": null,
      "txoddsId": null
    }
  },
  "ts": 1766427338743,
  "entryId": "1766427338743-4273"
}

​
Example: fixture update that includes a scores.result

Some fixture updates include a scores object (for example, a pre-game or result snapshot). 
{
  "channel": "fixtures",
  "type": "UPDATE",
  "payload": {
    "fixtureId": "id1102138464027567",
    "status": {
      "live": false,
      "statusId": 0,
      "statusName": "Pre-Game"
    },
    "sport": {
      "sportId": 11,
      "sportName": "Basketball"
    },
    "tournament": {
      "tournamentId": 21384,
      "tournamentName": "NCAA Women, Regular Season",
      "categoryName": "USA"
    },
    "season": {
      "seasonId": 133208,
      "seasonName": "NCAA Women, Regular Season 25/26"
    },
    "startTime": 1766426400,
    "trueStartTime": "2025-12-22T18:03:13.535381+00:00",
    "trueEndTime": null,
    "participants": {
      "participant1Id": 347062,
      "participant1RotNr": null,
      "participant1Name": "Sam Houston State Bearkats",
      "participant1Abbr": null,
      "participant2Id": 346978,
      "participant2RotNr": null,
      "participant2Name": "Northern Colorado Bears",
      "participant2Abbr": null
    },
    "scores": {
      "result": {
        "period": "result",
        "participant1Score": 7,
        "participant2Score": 2,
        "updatedAt": "2025-12-22T18:12:16.755551+00:00"
      }
    },
    "expectedPeriods": null,
    "periodLength": null,
    "externalProviders": {
      "betgeniusId": null,
      "betradarId": 64027567,
      "flashscoreId": "lxgZJCUG",
      "mollybetId": null,
      "oddinId": null,
      "opticoddsId": null,
      "pinnacleId": null,
      "sofascoreId": null,
      "lsportsId": null,
      "txoddsId": null
    }
  },
  "ts": 1766427343630,
  "entryId": "1766427343630-4278"
}