get_odds
Odds by game with bookmaker filters
When to use it
You need lines for one game: the consensus closing line for any game since 1999, plus per-book opening, closing, and latest snapshots for 2026 onwards.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| game_id | string | yes | Game id, e.g. 2026_01_KC_BUF |
| bookmaker | string | no | Bookmaker key (draftkings, fanduel, betmgm, caesars, espnbet) |
| snapshot_type | enum: opening | closing | latest | no | Return only one snapshot type. Default returns opening, closing, and latest per book. |
Request
curl -X POST https://football-mcp-production.up.railway.app/v1/get_odds \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"game_id": "2025_01_KC_LAC"
}'Over MCP, ask for it in plain English and the client calls get_odds itself. Point any MCP client at https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY.
Response
{
"game_id": "2025_01_KC_LAC",
"home_team": "LAC",
"away_team": "KC",
"kickoff": "2025-09-06T00:00:00.000Z",
"consensus_closing": {
"spread_line": -3,
"total_line": 47.5,
"home_moneyline": 145,
"away_moneyline": -175
},
"books": [],
"bookmaker_count": 0,
"count": 0,
"note": "No per-bookmaker snapshots stored for this game (snapshots begin with the 2026 season). consensus_closing is the nflverse closing line."
}Response fields
| Field | Type | Description |
|---|---|---|
| game_id | string | |
| home_team | string | |
| away_team | string | |
| kickoff | string | |
| consensus_closing | object | |
| consensus_closing.spread_line | number | |
| consensus_closing.total_line | number | |
| consensus_closing.home_moneyline | number | |
| consensus_closing.away_moneyline | number | |
| books[] | array | List |
| bookmaker_count | number | |
| count | number | |
| note | string |
Related endpoints
Returns the game_id this one takes.
Upcoming games by week or for the next N days
Returns the game_id this one takes.
Query games by season, week, team, date, type, or status, with closing lines
Takes the game_id this one returns.
Full game detail with team stats, starting QBs, odds, weather, and officials
Takes the game_id this one returns.
Time-series odds grouped by bookmaker
Try it
500 credits free on signup — 50 calls to get_odds — and no card.