Skip to main content

​
What it streams

Metadata per bookmaker describing whether a bookmaker offers odds for a given future, and whether those odds are active, stale, or suspended. This is the future equivalent of the bookmakers channel for fixtures.

​
Routing

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

​
Payload structure

FieldTypeDescription
futureIdstringThe future this update applies to
bookmakersobjectMap of <bookmaker> → metadata object
bookmakers.<bk>.bookmakerstringBookmaker slug (e.g. "stake", "pinnacle")
bookmakers.<bk>.bookmakerFutureIdstring | nullOptional bookmaker-side identifier for this future
bookmakers.<bk>.futurePathstring | nullOptional deeplink or path to the future at the bookmaker
bookmakers.<bk>.hasOddsbooleanTrue if the bookmaker currently offers odds
bookmakers.<bk>.staleOddsbooleanTrue if odds haven’t been updated recently
bookmakers.<bk>.suspendedbooleanTrue if the bookmaker has suspended this future
bookmakers.<bk>.metaobject | nullOptional bookmaker-specific metadata
bookmakers.<bk>.updatedAtstringLast update timestamp (ISO 8601)

​
Example message

{
  "channel": "bookmakersFutures",
  "type": "UPDATE",
  "payload": {
    "futureId": "id11028543137888",
    "bookmakers": {
      "stake": {
        "bookmaker": "stake",
        "bookmakerFutureId": "285431-nbl-new-zealand",
        "futurePath": null,
        "hasOdds": true,
        "staleOdds": false,
        "suspended": false,
        "meta": null,
        "updatedAt": "2025-12-28T18:37:13.719926+00:00"
      }
    }
  },
  "ts": 1766947033889,
  "entryId": "1766947033889-501"
}

​
Notes

  • Odds data itself is streamed via oddsFutures
  • If a bookmaker is missing from bookmakers, assume no current odds
  • Use this channel to:
    • detect stale or suspended futures
    • decide when to ignore or invalidate oddsFutures data
  • Semantics are intentionally identical to bookmakers (fixture-level), just scoped to futureId