Skip to content

get_odds

5 creditsStats + aggregationPOST /v1/get_odds

Every sportsbook's moneyline, spread and total for a game (5) or a day (10), with results against the line

Use it when you need each sportsbook's moneyline, spread and total for a game or a day, with results against the median close, to backtest.

Parameters

game_idstringoptional
One game.
datestringoptional
A day's games, YYYY-MM-DD (US Eastern).

Notes

  • Over MCP, ask for it in plain English and the client calls get_odds itself. Point any MCP client at https://mcp.dunkapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 5 credits, taken before it runs and refunded if the server errors.
  • Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.dunkapi.com/v1/get_odds \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "401585601"
}'

Response

json
{
  "games": [
    {
      "game_id": "401585601",
      "season": 2024,
      "season_type": "regular",
      "date": "2024-03-16",
      "starts_at": "2024-03-17T00:30:00.000Z",
      "status": "final",
      "home": {
        "team_id": "13",
        "abbrev": "LAL",
        "name": "Los Angeles Lakers",
        "score": 121
      },
      "away": {
        "team_id": "9",
        "abbrev": "GS",
        "name": "Golden State Warriors",
        "score": 128
      },
      "periods": 4,
      "overtime_periods": 0,
      "neutral_site": false,
      "conference_game": false,
      "venue": "crypto.com Arena",
      "city": "Los Angeles",
      "attendance": 18997,
      "books": [
        {
          "provider": "BetfairSportsbook",
          "home_ml_open": -163,
          "home_ml_close": -125,
          "away_ml_open": 125,
          "away_ml_close": 100,
          "home_close_prob": 0.556,
          "away_close_prob": 0.5,
          "home_spread_open": -3,
          "home_spread_close": -1.5,
          "spread_home_odds": -111,
          "spread_away_odds": -111,
          "total_open": 240.5,
          "total_close": 233.5,
          "over_odds": -111,
          "under_odds": -111,
          "captured_at": "2026-10-06T18:38:25.772Z"
        },
        {
          "provider": "Caesars Sportsbook (Colorado)",
          "home_ml_open": -155,
          "home_ml_close": -125,
          "away_ml_open": 130,
          "away_ml_close": 105,
          "home_close_prob": 0.556,
          "away_close_prob": 0.488,
          "home_spread_open": -3.5,
          "home_spread_close": -1.5,
          "spread_home_odds": -110,
          "spread_away_odds": -110,
          "total_open": 236.5,
          "total_close": 233.5,
          "over_odds": -105,
          "under_odds": -115,
          "captured_at": "2026-10-06T18:38:25.772Z"
        },
        {
          "provider": "Caesars Sportsbook (New Jersey)",
          "home_ml_open": -155,
          "home_ml_close": -120,
          "away_ml_open": 130,
          "away_ml_close": 100,
          "home_close_prob": 0.545,
          "away_close_prob": 0.5,
          "home_spread_open": -3.5,
          "home_spread_close": -1.5,
          "spread_home_odds": -110,
          "spread_away_odds": -110,
          "total_open": 236.5,
          "total_close": 233.5,
          "over_odds": -105,
          "under_odds": -115,
          "captured_at": "2026-10-06T18:38:25.772Z"
        }
      ],
      "result": {
        "median_home_spread": -1.5,
        "median_total": 233.5,
        "home_covered": false,
        "over": true
      }
    }
  ],
  "count": 10
}

Response fields

games[]array
List of objects
games[].game_idstring
games[].seasonnumber
games[].season_typestring
games[].datestring
games[].starts_atstring
games[].statusstring
games[].homeobject
games[].home.team_idstring
games[].home.abbrevstring
games[].home.namestring
games[].home.scorenumber
games[].awayobject
games[].away.team_idstring
games[].away.abbrevstring
games[].away.namestring
games[].away.scorenumber
games[].periodsnumber
games[].overtime_periodsnumber
games[].neutral_siteboolean
games[].conference_gameboolean
games[].venuestring
games[].citystring
games[].attendancenumber
games[].books[]array
List of objects
games[].books[].providerstring
games[].books[].home_ml_opennumber
games[].books[].home_ml_closenumber
games[].books[].away_ml_opennumber
games[].books[].away_ml_closenumber
games[].books[].home_close_probnumber
games[].books[].away_close_probnumber
games[].books[].home_spread_opennumber
games[].books[].home_spread_closenumber
games[].books[].spread_home_oddsnumber
games[].books[].spread_away_oddsnumber
games[].books[].total_opennumber
games[].books[].total_closenumber
games[].books[].over_oddsnumber
games[].books[].under_oddsnumber

Related endpoints

Try it

500 credits free on signup: 100 calls to get_odds, and no card.