How often does an MLB hitter go over his total bases line?

The call

player_id comes from search_players. Other markets include hits, home runs, RBI, pitcher strikeouts and pitcher outs.

import requests
import pandas as pd

API_KEY = "YOUR_API_KEY"

resp = requests.post(
    "https://mcp.fastballapi.com/v1/get_prop_history",
    headers={"x-api-key": API_KEY},
    json={
        "player_id": "33192",
        "market": "batter_total_bases",
        "from_date": "2026-03-01",
        "to_date": "2026-10-31",
        "limit": 200,
    },
    timeout=60,
)
resp.raise_for_status()
data = resp.json()["data"]

games = pd.DataFrame(data["games"])
s = data["summary"]
print(data["player_name"], data["stat"], "|", s["overs"], "overs,", s["unders"], "unders, over rate", s["over_rate"])
print(games[["game_date", "line", "over_odds", "under_odds", "actual", "result"]].tail(6).to_string(index=False))
# Overs by month: a hot April and a cold May read the same in a season total.
games["month"] = games["game_date"].str[:7]
print(games.groupby("month")["result"].value_counts().unstack(fill_value=0))

Replace YOUR_API_KEY with a key from your dashboard. Python needs requests and pandas (pip install requests pandas). JavaScript runs on Node 18 or newer, or in the browser.

Or use the official client: pip install fastballapi

What comes back

The data object of the response, trimmed to the first rows. Every field is real output from the run above.

{
  "player_id": "33192",
  "player_name": "Aaron Judge",
  "market": "batter_total_bases",
  "stat": "total bases",
  "bookmaker": null,
  "games": [
    {
      "game_id": "401814702",
      "game_date": "2026-03-25",
      "line": 1.5,
      "open_line": 1.5,
      "over_odds": -125,
      "under_odds": -110,
      "books": 7,
      "actual": 0,
      "result": "under",
      "margin": -1.5
    },
    {
      "game_id": "401814721",
      "game_date": "2026-03-27",
      "line": 1.5,
      "open_line": 1.5,
      "over_odds": -132,
      "under_odds": 102,
      "books": 7,
      "actual": 4,
      "result": "over",
      "margin": 2.5
    },
    {
      "game_id": "401814734",
      "game_date": "2026-03-28",
      "line": 1.5,
      "open_line": 1.5,
      "over_odds": -116,
      "under_odds": -117,
      "books": 7,
      "actual": 4,
      "result": "over",
      "margin": 2.5
    },
    {
      "game_id": "401814748",
      "game_date": "2026-03-30",
      "line": 1.5,
      "open_line": 1.5,
      "over_odds": 109,
      "under_odds": -141,
      "books": 7,
      "actual": 1,
      "result": "under",
      "margin": -0.5
    }
  ],
  "count": 64,
  "summary": {
    "games": 64,
    "graded": 63,
    "overs": 27,
    "unders": 36,
    "pushes": 0,
    "over_rate": 0.429,
    "avg_line": 1.5,
    "avg_actual": 1.8
  },
  "truncated": false,
  "next_from_date": null,
  "note": "1 of 64 games have no result yet (not played, or no box score or play-by-play of ours for the player)."
}

What to do next

• get_player_props (10 credits). Every sportsbook's total bases line for a game.
• get_player_games (5 credits). His game-by-game batting line.
• get_spray_chart (10 credits). Where his balls in play land.

More guides

• Where do I get MLB pitch-by-pitch data for a model?
• How do I get a pitcher's pitch mix and whiff rate in Python?
• How do I build an MLB spray chart in Python?
• How do I find MLB teams that over- or underperformed their run differential?

The same guide for other sports

• PuckAPI: How do I compare NHL player prop lines across sportsbooks?
• EndzoneAPI: How do I compare NFL player prop lines across sportsbooks?
• StrikerAPI: How do I get anytime goalscorer odds and results for a player in Python?
• DunkAPI: How do I compare NBA player prop lines across sportsbooks?