get_player_props

10 creditsMulti-tablePOST /v1/get_player_props

Player prop lines by sportsbook, opening and closing

Use it when you are backtesting or shopping player props: every book's over and under on hits and the other markets for a game, or one player's lines across a range of dates, with the opening or closing price. From May 2023.

Parameters

game_idstringoptional: Game id: every player's props for that game.
player_idstringoptional: Player id (e.g. 33192) from search_players. With from_date: that player's props across games.
from_datestringoptional: With player_id: first date, YYYY-MM-DD (the game's date).
to_datestringoptional: With player_id: last date (default: no end), YYYY-MM-DD (the game's date).
marketenum: batter_hits | batter_home_runs | batter_total_bases | batter_rbis | pitcher_strikeouts | pitcher_outsoptional: One market: batter_hits (hits), batter_home_runs (home runs), batter_total_bases (total bases), batter_rbis (runs batted in), pitcher_strikeouts (pitcher strikeouts), pitcher_outs (pitcher outs recorded)
bookmakerstringoptional: Bookmaker key, e.g. draftkings, fanduel, pinnacle.
snapshot_typeenum: opening | closingoptional: closing (default): the last line before the game starts. opening: the first one captured.
estimate_onlybooleanoptional: Return what this call would cost, without charging or running it.

Notes

Over MCP, ask for it in plain English and the client calls get_player_props itself. Point any MCP client at https://mcp.fastballapi.com/mcp?key=YOUR_API_KEY.
Each call costs 10 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_player_props \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "401569000",
  "market": "batter_hits"
}'

Response

json

{
  "snapshot_type": "closing",
  "games": 1,
  "props": [
    {
      "game_id": "401569000",
      "game_date": "2023-09-02",
      "player_name": "Example Player",
      "player_id": "0000001",
      "market": "batter_hits",
      "bookmaker": "draftkings",
      "line": 1.5,
      "over_odds": -115,
      "under_odds": -105,
      "captured_at": "2023-09-02T22:30:00.000Z",
      "source": "the_odds_api"
    },
    {
      "game_id": "401569000",
      "game_date": "2023-09-02",
      "player_name": "Example Player",
      "player_id": "0000001",
      "market": "batter_hits",
      "bookmaker": "fanduel",
      "line": 1.5,
      "over_odds": -110,
      "under_odds": -110,
      "captured_at": "2023-09-02T22:31:00.000Z",
      "source": "the_odds_api"
    },
    {
      "game_id": "401569000",
      "game_date": "2023-09-02",
      "player_name": "Example Player",
      "player_id": "0000001",
      "market": "batter_hits",
      "bookmaker": "pinnacle",
      "line": 1.5,
      "over_odds": -108,
      "under_odds": -104,
      "captured_at": "2023-09-02T22:29:00.000Z",
      "source": "the_odds_api"
    }
  ],
  "count": 3,
  "note": "Illustrative example: made-up player and numbers, to show the shape of a response."
}