Skip to content

get_odds

5 creditsStats + aggregationPOST /v1/get_odds

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).

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": "ESPN BET",
          "home_ml_open": -175,
          "home_ml_close": -195,
          "away_ml_open": 150,
          "away_ml_close": 160,
          "home_close_prob": 0.661,
          "away_close_prob": 0.385,
          "home_run_line_open": -1.5,
          "home_run_line_close": -1.5,
          "run_line_home_odds": 110,
          "run_line_away_odds": -130,
          "total_open": 8.5,
          "total_close": 8.5,
          "over_odds": 100,
          "under_odds": -120,
          "captured_at": "2026-10-07T21:34:31.907Z"
        }
      ],
      "result": {
        "median_home_ml": -195,
        "median_total": 8.5,
        "favourite_won": true,
        "over": false
      }
    }
  ],
  "count": 1
}

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_opennumber
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

Related endpoints

Try it

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