OpenOddsAPI API Get started

Sports Guides

NFL

Regular season and playoff coverage. Each game is an event with full team names in home_team and away_team. The pre-match market set opens roughly a week before kickoff.

Markets

MarketKeyNotes
MoneylinemoneylineGame winner; no ties in NFL regular season.
SpreadspreadPoint spread, e.g. -2.5 for the favourite.
Total pointstotal_pointsOver/under on combined final score.
Alternate spread / totalalternate_spread, alternate_totalNon-standard lines at shifted prices.
Team totalsteam_totalsOver/under on one team's score.
First halffirst_halfMoneyline, spread and total for the first half only.
Player propsplayer_propsPassing/rushing/receiving yards and touchdowns.
NOTENFL totals and spreads settle on the final score including overtime. First-half markets settle at halftime, before overtime.

Example — get game odds

The spread for Week 1 Thursday Night Football, US books:

GET/v1/sports/nfl/odds?market=spread®ion=usAPI key

Returns spread odds for every open NFL game.

Request

cURL
curl "https://api.openoddsapi.com/v1/sports/nfl/odds?market=spread&region=us" \
  -H "X-API-Key: sk_test_your_key_here"
200 OK — array of odds records
JSON
[
  {
    "id": "odd_nfl_20260910_chiefs_bills_draftkings_spread",
    "sport_key": "nfl",
    "event_id": "evt_nfl_20260910_chiefs_bills",
    "bookmaker": "draftkings",
    "market": "spread",
    "format": "american",
    "last_update": "2026-08-07T02:14:33Z",
    "outcomes": [
      { "name": "Kansas City Chiefs", "price": -110, "point": -2.5 },
      { "name": "Buffalo Bills", "price": -110, "point": 2.5 }
    ]
  },
  {
    "id": "odd_nfl_20260910_chiefs_bills_fanduel_spread",
    "sport_key": "nfl",
    "event_id": "evt_nfl_20260910_chiefs_bills",
    "bookmaker": "fanduel",
    "market": "spread",
    "format": "american",
    "last_update": "2026-08-07T02:14:31Z",
    "outcomes": [
      { "name": "Kansas City Chiefs", "price": -108, "point": -3.0 },
      { "name": "Buffalo Bills", "price": -112, "point": 3.0 }
    ]
  }
]

Settlement notes

  • Lines close at kickoff; live odds are served while the game is in progress for select markets.
  • Player props settle against official league statistics as finalised by the league.
  • Postponed games void pre-match markets for the original kickoff and reprice when rescheduled.
OpenOddsAPI API — Documentation v1Examples use illustrative data