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
| Market | Key | Notes |
|---|---|---|
| Moneyline | moneyline | Game winner; no ties in NFL regular season. |
| Spread | spread | Point spread, e.g. -2.5 for the favourite. |
| Total points | total_points | Over/under on combined final score. |
| Alternate spread / total | alternate_spread, alternate_total | Non-standard lines at shifted prices. |
| Team totals | team_totals | Over/under on one team's score. |
| First half | first_half | Moneyline, spread and total for the first half only. |
| Player props | player_props | Passing/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 keyReturns spread odds for every open NFL game.
Request
cURL
curl "https://api.openoddsapi.com/v1/sports/nfl/odds?market=spread®ion=us" \
-H "X-API-Key: sk_test_your_key_here"JavaScript
const url = "https://api.openoddsapi.com/v1/sports/nfl/odds" +
"?market=spread®ion=us";
const res = await fetch(url, {
headers: { "X-API-Key": "sk_test_your_key_here" }
});
const odds = await res.json();
console.log(odds);Python
import requests
url = "https://api.openoddsapi.com/v1/sports/nfl/odds"
res = requests.get(
url,
params={"market": "spread", "region": "us"},
headers={"X-API-Key": "sk_test_your_key_here"},
)
print(res.json())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.