get_leaders
5 creditsStats + aggregationPOST /v1/get_leaders
Data refreshed · changelog
Season leaders among qualified batters and pitchers
Use it when you want who leads a stat among qualified players: OPS or RE24 for hitters, ERA or K/9 for pitchers.
Parameters
statenum: avg | obp | slg | ops | hr | re24 | bb_pct | k_pct | era | whip | so | k_per_9 | bb_per_9requiredseasonnumber | stringoptional- Season (a year, e.g. 2025; default: the latest).
min_paintegeroptional- Override the plate-appearance minimum.
min_ipintegeroptional- Override the innings minimum.
limitintegeroptionalleagueenum: mlb | ncaabaseoptional- League. Defaults to mlb. One of: mlb, ncaabase.
Notes
- Over MCP, ask for it in plain English and the client calls
get_leadersitself. Point any MCP client athttps://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_leaders \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"stat": "ops",
"season": 2025,
"limit": 3
}'Response
json
{
"stat": "ops",
"season": 2025,
"qualifier": "502 plate appearances",
"leaders": [
{
"player_id": "33192",
"name": "Aaron Judge",
"team": "NYY",
"pa": 679,
"avg": 0.331,
"obp": 0.457,
"slg": 0.688,
"ops": 1.144,
"k_pct": 0.236,
"bb_pct": 0.183,
"hr": 53,
"re24": 74.3
},
{
"player_id": "39832",
"name": "Shohei Ohtani",
"team": "LAD",
"pa": 728,
"avg": 0.281,
"obp": 0.391,
"slg": 0.621,
"ops": 1.012,
"k_pct": 0.257,
"bb_pct": 0.15,
"hr": 55,
"re24": 59.3
},
{
"player_id": "32078",
"name": "George Springer",
"team": "TOR",
"pa": 586,
"avg": 0.309,
"obp": 0.399,
"slg": 0.56,
"ops": 0.959,
"k_pct": 0.189,
"bb_pct": 0.118,
"hr": 32,
"re24": 37.6
}
],
"count": 3
}Response fields
statstringseasonnumberqualifierstringleaders[]array- List of objects
leaders[].player_idstringleaders[].namestringleaders[].teamstringleaders[].panumberleaders[].avgnumberleaders[].obpnumberleaders[].slgnumberleaders[].opsnumberleaders[].k_pctnumberleaders[].bb_pctnumberleaders[].hrnumberleaders[].re24numbercountnumber
Used in
Related endpoints
get_player5 cr
Takes the player_id this one returns.
Season batting (AVG, OBP, SLG, OPS, RE24) and pitching (ERA, WHIP, K/9)
get_player_games5 cr
Takes the player_id this one returns.
A player's full batting and pitching game log
list_teams1 cr
Filters by the same season and league.
Team ids, abbreviations and colours for a season
search_players1 cr
Filters by the same limit and league.
Find players by name
Try it
500 free credits every month: 100 calls to get_leaders, and no card.