Odds

An oddID is a unique identifier for a specific betting option. It identifies a specific side/outcome to bet on within a specific market.

oddID Format

The oddID combines multiple identifiers into a single unique value:

{statID}-{statEntityID}-{periodID}-{betTypeID}-{sideID}

Component	Description	Examples
statID	The statistic being wagered on	points, touchdowns, assists
statEntityID	Who the stat applies to	home, away, all, or a playerID
periodID	The time period covered	game, 1h, 1q
betTypeID	The type of bet	ml, sp, ou
sideID	Which side of the bet	home, away, over, under

Example oddIDs

oddID	Description
points-home-game-ml-home	Moneyline bet on the home team to win the full game
points-away-game-sp-away	Spread bet on the away team for the full game
points-all-game-ou-over	Over bet on total points for the full game
points-home-1h-ml-home	Moneyline bet on the home team to win the 1st half
assists-LEBRON_JAMES_NBA-game-ou-over	Over bet on Lebron James assists for the full game

Accessing Odds

Each event returned by the /events endpoint contains odds data in the odds field. The odds field is an object where each key is an oddID and the value contains all data related to that betting option. In other words, you can access odds data by looking at odds.<oddID> for a given oddID.

{
  "eventID": "...",
  "odds": {
    "points-home-game-ml-home": {
      "oddID": "points-home-game-ml-home",
      "statID": "points",
      "statEntityID": "home",
      "periodID": "game",
      "betTypeID": "ml",
      "sideID": "home",
      "fairOdds": "-110",
      "bookOdds": "-115",
      "byBookmaker": {
        "draftkings": { "odds": "-112", "available": true },
        "fanduel": { "odds": "-118", "available": true }
      }
    },
    "points-all-game-ou-over": {
      "oddID": "points-all-game-ou-over",
      "statID": "points",
      "statEntityID": "all",
      "periodID": "game",
      "betTypeID": "ou",
      "sideID": "over",
      "fairOdds": "-108",
      "fairOverUnder": "224.5",
      "bookOdds": "-110",
      "bookOverUnder": "224.5",
      "byBookmaker": {
        "draftkings": { "odds": "-110", "overUnder": "224.5", "available": true }
      }
    }
  }
}

Key Odds Fields

Field	Description
fairOdds	Consensus odds without juice (vig removed)
bookOdds	Consensus odds across bookmakers (includes juice)
fairSpread / bookSpread	The spread/handicap value (for spread bets)
fairOverUnder / bookOverUnder	The over/under line (for O/U bets)
byBookmaker	Odds broken down by individual bookmaker
started / ended	Whether the bet period has started or ended
score	The final result value (when available)

Filtering by oddID

Use the oddID query parameter on the /events endpoint to request specific odds:

/events?oddID=points-home-game-ml-home,points-all-game-ou-over

Use includeOpposingOdds=true to automatically include the opposite side of each requested oddID.

See Supported Markets for a complete list of oddID values supported for each league and bookmaker.