Skip to content

get_odds

5 creditsStats + aggregationPOST /v1/get_odds

Data refreshed · changelog

Every sportsbook's moneyline, run line and total for a game (5) or a day (10)

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

Parameters

game_idstringoptional
datestringoptional
A day's games, YYYY-MM-DD (US Eastern).
leagueenum: mlb | ncaabaseoptional
League. Defaults to mlb. One of: mlb, ncaabase.

Notes

  • Over MCP, ask for it in plain English and the client calls get_odds itself. Point any MCP client at https://mcp.fastballapi.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.fastballapi.com/v1/get_odds \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "401569531"
}'

Response

json
{
  "games": [
    {
      "game_id": "401569531",
      "season": 2024,
      "season_type": "regular",
      "date": "2024-06-15",
      "starts_at": "2024-06-15T20:05:00.000Z",
      "status": "final",
      "home": {
        "team_id": "1",
        "abbrev": "BAL",
        "name": "Baltimore Orioles",
        "runs": 6,
        "hits": 11,
        "errors": 0
      },
      "away": {
        "team_id": "22",
        "abbrev": "PHI",
        "name": "Philadelphia Phillies",
        "runs": 2,
        "hits": 7,
        "errors": 1
      },
      "innings": 9,
      "extra_innings": false,
      "venue": "Oriole Park at Camden Yards",
      "city": "Baltimore",
      "attendance": 44555,
      "books": [
        {
          "provider": "BetMGM",
          "home_ml_open": -185,
          "home_ml_close": -190,
          "away_ml_open": 150,
          "away_ml_close": 155,
          "home_close_prob": 0.655,
          "away_close_prob": 0.392,
          "home_run_line_open": null,
          "home_run_line_close": -1.5,
          "run_line_home_odds": 105,
          "run_line_away_odds": -125,
          "total_open": 9,
          "total_close": 8,
          "over_odds": -115,
          "under_odds": -105,
          "captured_at": "2024-06-15T20:00:38.000Z"
        }
      ],
      "result": {
        "median_home_ml": -188,
        "median_total": 8,
        "favourite_won": true,
        "over": null
      }
    }
  ],
  "count": 8
}

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.runsnumber
games[].home.hitsnumber
games[].home.errorsnumber
games[].awayobject
games[].away.team_idstring
games[].away.abbrevstring
games[].away.namestring
games[].away.runsnumber
games[].away.hitsnumber
games[].away.errorsnumber
games[].inningsnumber
games[].extra_inningsboolean
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_run_line_opennull
games[].books[].home_run_line_closenumber
games[].books[].run_line_home_oddsnumber
games[].books[].run_line_away_oddsnumber
games[].books[].total_opennumber
games[].books[].total_closenumber

Used in

Related endpoints

Try it

500 free credits every month: 100 calls to get_odds, and no card.