Skip to main content

What it streams

Metadata about which bookmakers are offering odds for a given fixture, and whether those odds are active, stale, suspended, or rotated. This stream complements the odds channel by giving you per-bookmaker status for each fixtureId.

Routing

  • Entity key: payload.fixtureId
  • Filters: sportIds, tournamentIds, fixtureIds, bookmakers
  • Access: determined by your apiKey
  • Bookmaker-gated: ✅ Yes

Payload structure

FieldTypeDescription
fixtureIdstringThe fixture this update applies to
bookmakersobjectMap of <bookmaker> → metadata object
bookmakers.<bk>.bookmakerstringBookmaker slug (e.g. "stake", "pinnacle")
bookmakers.<bk>.bookmakerFixtureIdstring | nullOptional bookmaker-side ID (may be a slug or compound string)
bookmakers.<bk>.fixturePathstring | nullOptional bookmaker path or UI route (if supported)
bookmakers.<bk>.hasOddsbooleanTrue if the bookmaker currently offers any odds
bookmakers.<bk>.staleOddsbooleanTrue if odds haven’t updated recently
bookmakers.<bk>.suspendedbooleanTrue if this bookmaker’s odds are suspended
bookmakers.<bk>.participantsRotatedbooleanTrue if participants have been rotated compared to baseline
bookmakers.<bk>.metaobject | nullOptional metadata (bookmaker-specific)
bookmakers.<bk>.updatedAtstringLast update timestamp (ISO 8601)

Example message

{
  "channel": "bookmakers",
  "type": "UPDATE",
  "payload": {
    "fixtureId": "id1500026861811720",
    "bookmakers": {
      "stake": {
        "bookmaker": "stake",
        "bookmakerFixtureId": "46137681-avtomobilist-yekaterinburg-hc-lada-togliatti",
        "fixturePath": null,
        "hasOdds": true,
        "staleOdds": false,
        "suspended": false,
        "participantsRotated": false,
        "meta": null,
        "updatedAt": "2025-12-28T18:37:13.719926+00:00"
      }
    }
  },
  "ts": 1766947033889,
  "entryId": "1766947033889-1"
}

Notes

  • This channel helps identify inactive/stale bookmaker data before odds processing.
  • If a bookmaker is not present in bookmakers, you should assume no current odds available for that fixture.
  • participantsRotated = true usually means team sides were reversed or mapped inconsistently across books.