BallparkPal API v1

Health check with database connectivity probe.

• Response fields: status.

curl -s "https://www.ballparkpal.com/api/v1/health"

Lists active market definitions.

• Response fields: marketKey, marketType, subjectType, displayName, usesLine, status.

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/markets"

Lists teams.

• Response fields: teamId, abv, city, nickname.

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/teams"

Lists players with optional filters.

• teamId (optional integer)
• q (optional text; search on FullName)
• Response fields: playerId, teamId, firstName, lastName, fullName.

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/players?teamId=147&q=judge"

Lists games by date (preferred) or by gameId.

• At least one of date=YYYY-MM-DD or gameId is required.
• Response fields: gameId, gameDate, gameTime, teamAwayId, teamHomeId, venueId.

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/games?date=2026-04-01"

Retrieves a single game by ID.

• Response fields: gameId, gameDate, gameTime, teamAwayId, teamHomeId, venueId.

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/games/776345"

Returns projections for a single game.

• gameId is required.
• Response fields: marketType, marketKey, displayName, line, side, odds, probability, average, subject (object: type, id), teamId (when applicable).
• average is the simulated average projection for the stat (e.g. projected hits, strikeouts). Null for probability-based markets like Moneyline and Pitcher Win.

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/projections?gameId=776345"

Returns Ballpark Pal modeled park factors for every game on a given date.

• date=YYYY-MM-DD is required.
• Percent fields are integers (e.g. 18 = 18%). Amount fields are decimals representing estimated stat changes.
• Response fields: gameId, gameTime, teamAway, teamHome, runsPercent, homeRunsPercent, doublesTriplesPercent, singlesPercent, runsAmount, homeRunsAmount, doublesTriplesAmount, singlesAmount.

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/parkfactors?date=2026-04-01"

Returns individual hitter park factors at the game level.

• At least one of date=YYYY-MM-DD or gameId is required.
• Response fields: gameId, gameTime, teamAway, teamHome, playerId, playerName, team, homeRuns, doublesTriples, singles.

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/parkfactors/hitters?date=2026-04-01"

Returns Ballpark Pal matchup model data for all batter-vs-starting-pitcher matchups on a given date. Probabilities are not park-adjusted; combine with /api/v1/parkfactors/hitters if park context is needed.

• date=YYYY-MM-DD (required)
• starters=true (optional; when set, only returns projected starting batters)
• Probability fields are percentages with one decimal place (e.g. 4.2 = 4.2%).
• VsTypical fields are integers representing percentage deviation from the batter's typical rate (e.g. 15 = 15% above typical, -8 = 8% below typical).
• Fields may be null when no starting pitcher is announced or no model data exists for the matchup.
• Response fields: gameId, batterId, batterName, batterTeam, pitcherId, pitcherName, pitcherTeam, homeRunProbability, doubleTripleProbability, singleProbability, walkProbability, strikeoutProbability, runsCreatedVsTypical, homeRunVsTypical, doubleTripleVsTypical, singleVsTypical, walkVsTypical, strikeoutVsTypical.

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/matchups?date=2026-04-01"

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/matchups?date=2026-04-01&starters=true"

Returns Ballpark Pal matchup model probabilities for any batter-pitcher pair. Probabilities are not park-adjusted.

• batterId (required integer; MLB player ID)
• pitcherId (required integer; MLB player ID)
• Probability fields are percentages with one decimal place.
• matchupAdvantage ranges from -10 (extreme pitcher advantage) to +10 (extreme batter advantage). 0 is neutral.
• batterPercentile and pitcherPercentile are raw 0–100 values from the model.
• Returns 404 if no model data exists for the given pair.
• Response fields: batterId, batterName, batterTeam, pitcherId, pitcherName, pitcherTeam, reachProbability, hitProbability, homeRunProbability, doubleTripleProbability, singleProbability, walkProbability, strikeoutProbability, matchupAdvantage, batterPercentile, pitcherPercentile.

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.ballparkpal.com/api/v1/matchups/predict?batterId=592450&pitcherId=477132"