get_prop_history

10 creditsMulti-tablePOST /v1/get_prop_history

A player's prop lines against what he did, game by game

Use it when you are asking whether a player beats his line: for one market, each game's closing line (the median across books), what he actually recorded in hits, and the over rate, from May 2023.

Parameters

player_idstringrequired: Player id (e.g. 33192) from search_players.
marketenum: batter_hits | batter_home_runs | batter_total_bases | batter_rbis | pitcher_strikeouts | pitcher_outsrequired: The 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)
from_datestringoptional: First date, YYYY-MM-DD (the game's date).
to_datestringoptional: Last date, YYYY-MM-DD (the game's date).
bookmakerstringoptional: One book's closing line instead of the median across books, e.g. draftkings.
limitintegeroptional: Games to return, oldest first (default 50, max 200). next_from_date says where to continue.

Notes

Over MCP, ask for it in plain English and the client calls get_prop_history 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_prop_history \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "0000001",
  "market": "batter_hits"
}'

Response

json

{
  "player_id": "0000001",
  "player_name": "Example Player",
  "market": "batter_hits",
  "stat": "hits",
  "bookmaker": null,
  "games": [
    {
      "game_id": "401569000",
      "game_date": "2023-09-02",
      "line": 1.5,
      "open_line": 1.5,
      "over_odds": -110,
      "under_odds": -110,
      "books": 7,
      "actual": 2,
      "result": "over",
      "margin": 0.5
    }
  ],
  "count": 1,
  "summary": {
    "games": 1,
    "graded": 1,
    "overs": 1,
    "unders": 0,
    "pushes": 0,
    "over_rate": 1,
    "avg_line": 1.5,
    "avg_actual": 2
  },
  "truncated": false,
  "next_from_date": null,
  "note": "Illustrative example: made-up player and numbers, to show the shape of a response."
}