Skip to content

get_game

5 creditsStats + aggregationPOST /v1/get_game

One game: every batting and pitching line, each book's line, win probability

Use it when you need one game in full: every batter's and pitcher's line, each book's line and the win-probability range.

Parameters

game_idstringrequired
ESPN game id, from get_games or get_schedule.

Notes

  • Over MCP, ask for it in plain English and the client calls get_game 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_game \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "401569531"
}'

Response

json
{
  "game": {
    "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
  },
  "batting": [
    {
      "player_id": "42507",
      "name": "Gunnar Henderson",
      "team_id": "1",
      "batting_order": 1,
      "position": "SS",
      "starter": true,
      "ab": 5,
      "r": 0,
      "h": 2,
      "rbi": 1,
      "hr": 0,
      "bb": 0,
      "so": 1,
      "pitches_seen": 19
    },
    {
      "player_id": "42178",
      "name": "Adley Rutschman",
      "team_id": "1",
      "batting_order": 2,
      "position": "C",
      "starter": true,
      "ab": 3,
      "r": 0,
      "h": 0,
      "rbi": 1,
      "hr": 0,
      "bb": 1,
      "so": 0,
      "pitches_seen": 20
    },
    {
      "player_id": "34940",
      "name": "Ryan Mountcastle",
      "team_id": "1",
      "batting_order": 3,
      "position": "1B",
      "starter": true,
      "ab": 4,
      "r": 1,
      "h": 1,
      "rbi": 0,
      "hr": 0,
      "bb": 0,
      "so": 1,
      "pitches_seen": 12
    }
  ],
  "pitching": [
    {
      "player_id": "41196",
      "name": "Grayson Rodriguez",
      "team_id": "1",
      "starter": true,
      "ip": "7.0",
      "outs": 21,
      "h": 7,
      "r": 2,
      "er": 2,
      "bb": 1,
      "so": 6,
      "hr": 1,
      "pitches": 99,
      "strikes": 73
    },
    {
      "player_id": "30653",
      "name": "Craig Kimbrel",
      "team_id": "1",
      "starter": false,
      "ip": "1.0",
      "outs": 3,
      "h": 0,
      "r": 0,
      "er": 0,
      "bb": 1,
      "so": 3,
      "hr": 0,
      "pitches": 16,
      "strikes": 11
    },
    {
      "player_id": "40884",
      "name": "Bryan Baker",
      "team_id": "1",
      "starter": false,
      "ip": "1.0",
      "outs": 3,
      "h": 0,
      "r": 0,
      "er": 0,
      "bb": 0,
      "so": 1,
      "hr": 0,
      "pitches": 11,
      "strikes": 6
    }
  ],
  "odds": [
    {
      "provider": "ESPN BET",
      "home_ml_open": -175,
      "home_ml_close": -195,
      "away_ml_open": 150,
      "away_ml_close": 160,
      "home_run_line_close": -1.5,
      "total_open": 8.5,
      "total_close": 8.5
    }
  ],
  "win_probability": {
    "home_min": 0.363,
    "home_max": 1,
    "plate_appearances_with_probability": 73
  },
  "plate_appearances": 73
}

Response fields

gameobject
game.game_idstring
game.seasonnumber
game.season_typestring
game.datestring
game.starts_atstring
game.statusstring
game.homeobject
game.home.team_idstring
game.home.abbrevstring
game.home.namestring
game.home.runsnumber
game.home.hitsnumber
game.home.errorsnumber
game.awayobject
game.away.team_idstring
game.away.abbrevstring
game.away.namestring
game.away.runsnumber
game.away.hitsnumber
game.away.errorsnumber
game.inningsnumber
game.extra_inningsboolean
game.venuestring
game.citystring
game.attendancenumber
batting[]array
List of objects
batting[].player_idstring
batting[].namestring
batting[].team_idstring
batting[].batting_ordernumber
batting[].positionstring
batting[].starterboolean
batting[].abnumber
batting[].rnumber
batting[].hnumber
batting[].rbinumber
batting[].hrnumber
batting[].bbnumber
batting[].sonumber

Related endpoints

Try it

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