# MLB Player Season Stats & Bio

> MLB Player Season Stats & Bio 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 hitting or pitching statistics plus biographical info from the official MLB Stats API for a given player ID and season year.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/mlb-stats?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-stats-bio-82fdfcc6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gaGO9yGf6P6bh0qycHSEB

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-stats-bio-82fdfcc6
```

Example prompt: Can you pull up Shohei Ohtani's hitting stats for the 2025 season? His MLB player ID is 660271.

## When to prefer this

Choose this endpoint when you need official, structured MLB season statistics for a specific player by their MLB person ID. It is ideal for fantasy sports analysis, sports journalism, player comparison, or any agent workflow requiring authoritative MLB data. Prefer this over web scraping or unofficial sources because it proxies the official MLB Stats API and returns clean structured JSON. Best for per-player, per-season lookups rather than leaderboard or game-feed queries.

## Known failure modes

- Invalid or unknown MLB player ID returns empty or error response
- Stat group not available for player (e.g. pitching stats for a position player) may return empty stats
- Season year out of range or before player's career returns no stats
- Missing required playerId parameter returns a validation error
- Rate limiting or upstream MLB Stats API downtime causes failure

## How this service works

MLB player season stats (hitting or pitching) and bio from the official MLB Stats API (statsapi.mlb.com). Input is the MLB person id; season stats only, no game feed. Free public data, MLB copyright applies.

## Output

A JSON object containing the player's biographical details (name, position, birth date, jersey number, active status), their team (name and ID), the requested stat group (hitting or pitching), a full stats object (e.g. avg, OBP, OPS, RBI, HR, SB for hitting), the season year, and the source URL from the official MLB Stats API, along with a timestamp of when the data was fetched.

## 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",
     "required": [
      "playerId"
     ],
     "properties": {
      "group": {
       "type": "string",
       "description": "hitting (default) or pitching"
      },
      "season": {
       "type": "string",
       "description": "Season year YYYY (default: 2025)"
      },
      "playerId": {
       "type": "string",
       "description": "MLB person id, e.g. 660271 (Shohei Ohtani)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "team": {
   "id": 119,
   "name": "Los Angeles Dodgers"
  },
  "group": "hitting",
  "stats": {
   "avg": ".282",
   "obp": ".392",
   "ops": "1.014",
   "rbi": 102,
   "slg": ".622",
   "hits": 172,
   "runs": 146,
   "atBats": 611,
   "doubles": 25,
   "homeRuns": 55,
   "strikeOuts": 187,
   "baseOnBalls": 109,
   "gamesPlayed": 158,
   "stolenBases": 20
  },
  "player": {
   "id": 660271,
   "name": "Shohei Ohtani",
   "active": true,
   "number": "17",
   "position": "Two-Way Player",
   "birthDate": "1994-07-05"
  },
  "season": 2025,
  "source": "https://statsapi.mlb.com/api/v1/people/660271/stats?stats=season&season=2025&group=hitting",
  "checkedAt": "2026-10-23T09:35:24.455Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mlb-player-season-stats-bio-82fdfcc6/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)