Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.oddspapi.io/llms.txt

Use this file to discover all available pages before exploring further.

​
What it streams

Realtime odds updates for long-term or season-based markets (“futures”), scoped to a futureId. Each update contains one or more prices per outcome, per bookmaker. Odds are grouped by bookmaker and keyed by participant within each bookmaker.

​
Routing

  • Entity key: payload.futureId
  • Filters: sportIds, tournamentIds, futureIds, bookmakers
  • Bookmaker-gated: ✅ Yes

​
Delivery semantics

  • This channel is high throughput
  • Updates are latest state only
  • Intermediate odds may be coalesced or dropped if the client lags
  • Do not rely on tick-by-tick delivery — treat it as a state stream

​
Payload structure

oddsId: 
<futureId>:<bookmaker>:<participantId>

​
outcome object (full schema)

Each entry in the oddsFutures map is an outcome, similar to the one used in the odds channel.
FieldTypeDescription
bookmakerstringBookmaker slug (e.g. "stake", "pinnacle", "polymarket")
participantIdinteger | nullParticipant (team/player) the odds apply to
pricenumberDecimal odds
activebooleanWhether the outcome is currently available
bookmakerOutcomeIdstring | nullBookmaker-native outcome ID
bookmakerChangedAtinteger | nullBookmaker-provided update timestamp (ms)
priceFractional`string`Fractional odds (e.g. "5/2")
priceAmerican`integer`American odds (e.g. +200, -120)
limitnumber | nullMax allowed stake (if applicable)
betslipstring | nullOptional bookmaker betslip/deeplink info
metaobject | nullBookmaker-specific metadata (e.g. ladders, ticks)
changedAtintegerEpoch milliseconds (UTC) when received by the gateway

​
Example: traditional bookmaker odds for futures

{
  "channel": "oddsFutures",
  "type": "UPDATE",
  "payload": {
    "futureId": "id11028543137888",
    "oddsFutures": {
      "stake": {
        "id11028543137888:stake:5432": {
          "bookmaker": "stake",
          "participantId": 5432,
          "price": 4.25,
          "active": true,
          "priceAmerican": +325,
          "priceFractional": "13/4",
          "limit": 500,
          "changedAt": 1766940100000
        }
      }
    }
  },
  "ts": 1766940100023,
  "entryId": "1766940100023-456"
}

​
Example: prediction market odds with orderbook metadata

{
  "channel": "oddsFutures",
  "type": "UPDATE",
  "payload": {
    "futureId": "id11028543137888",
    "oddsFutures": {
      "polymarket": {
        "id11028543137888:polymarket:5432": {
          "bookmaker": "polymarket",
          "participantId": 5432,
          "price": 3.25,
          "active": true,
          "bookmakerOutcomeId": "abc123xyz",
          "limit": 50,
          "meta": {
            "back": [
              { "price": 3.25, "size": 20 },
              { "price": 3.10, "size": 40 }
            ],
            "lay": [
              { "price": 3.40, "size": 15 }
            ]
          },
          "changedAt": 1766940123456
        }
      }
    }
  },
  "ts": 1766940123458,
  "entryId": "1766940123458-501"
}

​
Implementation guidance

  • Always use the oddsId as the unique ID for odds
  • Normalize prices as needed (decimal → American, etc.)
  • Join futureId to:
  • Use active=false to pause display or betting logic
  • Preserve all fields in meta even if unused (for forward compatibility)