Skip to content
Multi-table10 credits

get_odds

Odds for a specific game with optional bookmaker and snapshot type filters.

When to use it

You have a game ID and want the betting lines -- moneyline, spread, and total from specific bookmakers. Filter by opening or closing lines to see how the market priced the game.

Parameters

NameTypeRequiredDescription
game_idstringyesGame ID (e.g. "2025020887")
bookmakerstringnoFilter by bookmaker (e.g. "draftkings")
snapshot_typestringno"opening" (game-day morning) or "closing" (final pre-game). Default returns both.

Request

bash
curl -X POST https://mcp.puckapi.com/v1/get_odds \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "2025020887",
  "bookmaker": "draftkings"
}'

Over MCP, ask for it in plain English and the client calls get_odds itself. Point any MCP client at https://mcp.puckapi.com/mcp?key=YOUR_API_KEY.

Response

json
{
  "game_id": "2025020887",
  "home_team": "BUF",
  "away_team": "TOR",
  "game_date": "2026-03-15",
  "odds": [
    {
      "bookmaker": "draftkings",
      "snapshotType": "opening",
      "mlHome": -115,
      "mlAway": -105,
      "mlHomeProb": 0.535,
      "mlAwayProb": 0.512,
      "spreadHome": -1.5,
      "spreadHomeOdds": 170,
      "spreadAway": 1.5,
      "spreadAwayOdds": -200,
      "total": 6,
      "totalOverOdds": -110,
      "totalUnderOdds": -110,
      "capturedAt": "2026-03-14T12:00:00Z"
    },
    {
      "bookmaker": "draftkings",
      "snapshotType": "closing",
      "mlHome": -125,
      "mlAway": 105,
      "mlHomeProb": 0.556,
      "mlAwayProb": 0.488,
      "spreadHome": -1.5,
      "spreadHomeOdds": 165,
      "spreadAway": 1.5,
      "spreadAwayOdds": -195,
      "total": 6.5,
      "totalOverOdds": -110,
      "totalUnderOdds": -110,
      "capturedAt": "2026-03-15T18:50:00Z"
    }
  ],
  "bookmaker_count": 1
}

Response fields

FieldTypeDescription
game_idstringGame ID
home_teamstringHome team abbreviation
away_teamstringAway team abbreviation
odds[].bookmakerstringBookmaker name
odds[].snapshotTypestringopening or closing
odds[].mlHomeintegerHome moneyline
odds[].mlAwayintegerAway moneyline
odds[].mlHomeProbnumberImplied home win probability
odds[].mlAwayProbnumberImplied away win probability
odds[].spreadHomenumberHome puck line
odds[].spreadHomeOddsintegerHome spread price
odds[].spreadAwaynumberAway puck line
odds[].spreadAwayOddsintegerAway spread price
odds[].totalnumberOver/under total
odds[].totalOverOddsintegerOver price
odds[].totalUnderOddsintegerUnder price
odds[].capturedAtstringTimestamp of snapshot
bookmaker_countintegerNumber of bookmakers returned

Related endpoints

Try it

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