Skip to content
Multi-table10 credits

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

NameTypeRequiredDescription
game_idstringyesGame id, e.g. 2026_01_KC_BUF
bookmakerstringnoBookmaker key (draftkings, fanduel, betmgm, caesars, espnbet)
snapshot_typeenum: opening | closing | latestnoReturn only one snapshot type. Default returns opening, closing, and latest per book.

Request

bash
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

json
{
  "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

FieldTypeDescription
game_idstring
home_teamstring
away_teamstring
kickoffstring
consensus_closingobject
consensus_closing.spread_linenumber
consensus_closing.total_linenumber
consensus_closing.home_moneylinenumber
consensus_closing.away_moneylinenumber
books[]arrayList
bookmaker_countnumber
countnumber
notestring

Related endpoints

Try it

500 credits free on signup — 50 calls to get_odds — and no card.