Skip to content

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_9required
seasonnumber | stringoptional
Season (a year, e.g. 2025; default: the latest).
min_paintegeroptional
Override the plate-appearance minimum.
min_ipintegeroptional
Override the innings minimum.
limitintegeroptional
leagueenum: mlb | ncaabaseoptional
League. Defaults to mlb. One of: mlb, ncaabase.

Notes

  • Over MCP, ask for it in plain English and the client calls get_leaders itself. Point any MCP client at https://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

statstring
seasonnumber
qualifierstring
leaders[]array
List of objects
leaders[].player_idstring
leaders[].namestring
leaders[].teamstring
leaders[].panumber
leaders[].avgnumber
leaders[].obpnumber
leaders[].slgnumber
leaders[].opsnumber
leaders[].k_pctnumber
leaders[].bb_pctnumber
leaders[].hrnumber
leaders[].re24number
countnumber

Used in

Related endpoints

Try it

500 free credits every month: 100 calls to get_leaders, and no card.