---
title: "MLB batting/pitching season leaderboard"
method: GET
path: "/v1/mlb/leaders"
tags: ["mlb"]
---

# MLB batting/pitching season leaderboard

`GET /v1/mlb/leaders`

## Request

- Base URL: `https://api.bigballsdata.com`
- URL: `https://api.bigballsdata.com/v1/mlb/leaders`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Season batting/pitching leaderboard, computed at request time from
`player_stats` (no pre-aggregated season table exists yet; see
docs/baseball-player-stats-gap-scoping-2026-08-05.md). Batting and
pitching are split per the same rule GET /v1/players/{id}/stats?
sport=baseball uses: a player-game is pitching iff it carries
era/earnedRuns/innings-pitched, otherwise batting.
HONESTY: player_stats currently covers the 2026 season ONLY (no
earlier seasons exist yet), and current-season coverage itself is
partial (~76% of finished games at time of writing); every
response's `meta` carries `season_note`, `finished_games`,
`games_with_stats`, and `coverage_pct` so this is never presented as
complete or historical. `stat=era` sorts ascending (lower is
better); every other stat sorts descending. 5-minute cache.

## Query parameters

- `category` 'batting' | 'pitching'
- `stat` 'home_runs' | 'avg' | 'hits' | 'rbi' | 'runs' | 'stolen_bases' | 'walks' | 'strikeouts' | 'era' | 'innings_pitched' | 'hits_allowed' | 'earned_runs' | 'home_runs_allowed'
- `season` integer
- `min_games` integer
- `limit` integer

## Response `200`

ok. `{ data, meta }`; meta carries the coverage-honesty fields described above.

- object
  - `data` object, required
  - `meta` object
    - `cached` boolean
    - `cache_age_ms` integer
    - `season_note` string
    - `finished_games` integer
    - `games_with_stats` integer
    - `coverage_pct` number

## Other responses

- `400`: Invalid query parameters, or a stat that does not belong to the requested category.
- `404`: No baseball player_stats available for any season.

---

[API](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api.md) · [All operations](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/revisions/31fb54ac414e?raw)