# MLB Player Season Statistics Leaderboard

> MLB Player Season Statistics Leaderboard is a paid API for AI agents from api.fadeandco.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns MLB player season stats (batting, pitching, fielding) sorted as a leaderboard for any season from 2002 to present, sourced from ESPN's public stats API.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/baseball-reference?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mlb-player-season-statistics-leaderboard-158996dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IMn31CLr2PL84w_s7e3RV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mlb-player-season-statistics-leaderboard-158996dd
```

Example prompt: Who are the top 25 MLB home run leaders for the 2024 regular season? Show me their batting stats ranked by home runs.

## When to prefer this

Choose this endpoint when you need MLB player statistics ranked as a leaderboard, especially for quick top-N queries by stat category. It is ideal for regular season or postseason leaderboard queries from 2002 onward. Prefer this over Baseball-Reference scrapers (which block automation) or manual ESPN browsing. It covers both batters and pitchers in one API with flexible sorting.

## Known failure modes

- Invalid season year (outside 2002–present range) returns an error or empty result
- Invalid sort parameter returns an error or defaults to home runs
- Page number exceeding available data returns empty results array
- qualifiedOnly=false may return sparse or incomplete stats for players with few appearances
- Pitching stats null for position players; batting stats null for pitchers

## How this service works

MLB player season statistics, sorted leaderboard (default home runs): per player team, position, batting (G, AB, R, H, 2B, 3B, HR, RBI, BB, SO, SB, AVG, OBP, SLG, OPS, WAR), pitching (GS, W, L, SV, HLD, IP, ERA, WHIP, K/9, WAR) and fielding. Regular season or postseason, 2002 to now. ERA and WHIP sort lowest first. Data from ESPN's public stats API (Baseball-Reference blocks automated access).

## Output

A paginated JSON leaderboard of MLB players with full batting (G, AB, R, H, 2B, 3B, HR, RBI, BB, SO, SB, AVG, OBP, SLG, OPS, WAR), pitching (GS, W, L, SV, HLD, IP, ERA, WHIP, K/9, WAR), and fielding stats per player, along with player name, ID, team abbreviation, team name, position, age, season year, and source URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "page": {
       "type": "string",
       "description": "Page, 1 to 40"
      },
      "sort": {
       "type": "string",
       "description": "homeruns, avg, rbi, hits, ops, stolenbases, war, era, strikeouts, wins, saves, whip"
      },
      "limit": {
       "type": "string",
       "description": "Players per page, 1 to 50 (default 25)"
      },
      "season": {
       "type": "string",
       "description": "Season year (default current)"
      },
      "seasonType": {
       "type": "string",
       "description": "regular (default) or playoffs"
      },
      "qualifiedOnly": {
       "type": "string",
       "description": "true (default) = only players meeting ESPN's minimums"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "page": 1,
  "sort": "homeruns",
  "season": 2026,
  "source": "https://www.espn.com/mlb/stats/player/_/season/2026/seasontype/2",
  "results": [
   {
    "age": 33,
    "team": "PHI",
    "stats": {
     "batting": {
      "OPS": 0.857,
      "avg": 0.232,
      "RBIs": 97,
      "hits": 135,
      "runs": 95,
      "WARBR": 2.58,
      "walks": 105,
      "atBats": 581,
      "doubles": 20,
      "slugAvg": 0.503,
      "triples": 1,
      "homeRuns": 45,
      "onBasePct": 0.354,
      "strikeouts": 220,
      "totalBases": 292,
      "gamesPlayed": 156,
      "stolenBases": 3
     },
     "fielding": {
      "errors": null,
      "assists": null,
      "putouts": null,
      "defWARBR": null,
      "doublePlays": null,
      "fieldingPct": null,
      "gamesPlayed": null,
      "passedBalls": null,
      "rangeFactor": null,
      "gamesStarted": null,
      "totalChances": null,
      "fullInningsPlayed": null,
      "catcherCaughtStealing": null,
      "catcherCaughtStealingPct": null,
      "catcherStolenBasesAllowed": null
     },
     "pitching": {
      "ERA": null,
      "WHIP": null,
      "hits": null,
      "wins": null,
      "WARBR": null,
      "holds": null,
      "saves": null,
      "walks": null,
      "losses": null,
      "innings": null,
      "homeRuns": null,
      "earnedRuns": null,
      "strikeouts": null,
      "gamesPlayed": null,
      "gamesStarted": null,
      "qualityStarts": null,
      "strikeoutsPerNineInnings": null
     }
    },
    "player": "Kyle Schwarber",
    "playerId": 33712,
    "position": "DH",
    "teamName": "Phillies"
   },
   {
    "age": 24,
    "team": "CHC",
    "stats": {
     "batting": {
      "OPS": 0.943,
      "avg": 0.28,
      "RBIs": 107,
      "hits": 175,
      "runs": 119,
      "WARBR": 9.83,
      "walks": 83,
      "atBats": 626,
      "doubles": 31,
      "slugAvg": 0.57,
      "triples": 8,
      "homeRuns": 45,
      "onBasePct": 0.372,
      "strikeouts": 187,
      "totalBases": 357,
      "gamesPlayed": 162,
      "stolenBases": 41
     },
     "fielding": {
      "errors": null,
      "assists": null,
      "putouts": null,
      "defWARBR": null,
      "doublePlays": null,
      "fieldingPct": null,
      "gamesPlayed": null,
      "passedBalls": null,
      "rangeFactor": null,
      "gamesStarted": null,
      "totalChances": null,
      "fullInningsPlayed": null,
      "catcherCaughtStealing": null,
      "catcherCaughtStealingPct": null,
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mlb-player-season-statistics-leaderboard-158996dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fadeandco.workers.dev](https://www.zero.xyz/host/api.fadeandco.workers.dev/llms.txt)