# NBA Player Season Statistics Leaderboard

> NBA 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 a paginated, sortable leaderboard of NBA player season statistics including scoring, rebounds, assists, shooting percentages, and more for regular season or playoffs from 2003 onward.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/nba-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/nba-player-season-statistics-leaderboard-686a9c4f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yKs0eKBiH3i-qYLEpwlEX

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 nba-player-season-statistics-leaderboard-686a9c4f
```

Example prompt: Who are the top 25 NBA players by points per game in the 2025-26 regular season? Sort by scoring and show me the first page.

## When to prefer this

Choose this endpoint when you need structured, sortable NBA player statistics across multiple statistical categories for any season from 2003 to present, covering both regular season and playoffs. It is preferable over scraping ESPN directly (which is fragile) or stats.nba.com (which blocks bots). Best for leaderboard-style queries, fantasy sports analysis, or comparing player performance across categories.

## Known failure modes

- Invalid sort field returns error or empty results
- Season year outside supported range (pre-2003 or future) may return no data
- Page number exceeding available data returns empty results array
- qualifiedOnly=false may return sparse stats for rarely-played players
- ESPN upstream API unavailability causes failure since stats.nba.com blocks automated access

## How this service works

NBA player season statistics, sorted leaderboard: per player team, position, age, games, minutes, points, rebounds, assists, steals, blocks, turnovers, FG/3P/FT made-attempted-percentage, double-doubles, triple-doubles (per-game and totals). Regular season or playoffs, 2003 to now (season = year it ends, 2026 = 2025-26). Data from ESPN's public stats API (stats.nba.com blocks automated access).

## Output

A JSON object with pagination metadata (page, season, sort, source URL) and an array of player records each containing player name, player ID, team abbreviation, team name, position, age, and a full stats breakdown split into general (games played, minutes, fouls, double-doubles, triple-doubles), offensive (points, assists, turnovers, FG/3P/FT made-attempted-percentage, all per-game and totals), and defensive (steals, blocks, per-game and totals) sub-objects.

## 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": "points, rebounds, assists, steals, blocks, threes, fgpct, minutes"
      },
      "limit": {
       "type": "string",
       "description": "Players per page, 1 to 50 (default 25)"
      },
      "season": {
       "type": "string",
       "description": "Season end year, e.g. 2026 for 2025-26 (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": "points",
  "season": 2026,
  "source": "https://www.espn.com/nba/stats/player/_/season/2026/seasontype/2",
  "results": [
   {
    "age": 27,
    "team": "LAL",
    "stats": {
     "general": {
      "fouls": 153,
      "minutes": 2289,
      "avgFouls": 2.391,
      "rebounds": 495,
      "ejections": 0,
      "avgMinutes": 35.766,
      "avgRebounds": 7.734,
      "gamesPlayed": 64,
      "doubleDouble": 34,
      "tripleDouble": 8,
      "flagrantFouls": 0,
      "technicalFouls": 17
     },
     "defensive": {
      "blocks": 34,
      "steals": 105,
      "avgBlocks": 0.531,
      "avgSteals": 1.641
     },
     "offensive": {
      "points": 2143,
      "assists": 530,
      "avgPoints": 33.484,
      "turnovers": 255,
      "avgAssists": 8.281,
      "avgTurnovers": 3.984,
      "fieldGoalPct": 47.563,
      "freeThrowPct": 77.984,
      "fieldGoalsMade": 693,
      "freeThrowsMade": 503,
      "avgFieldGoalsMade": 10.828,
      "avgFreeThrowsMade": 7.859,
      "fieldGoalsAttempted": 1457,
      "freeThrowsAttempted": 645,
      "avgFieldGoalsAttempted": 22.766,
      "avgFreeThrowsAttempted": 10.078,
      "threePointFieldGoalPct": 36.599,
      "threePointFieldGoalsMade": 254,
      "avgThreePointFieldGoalsMade": 3.969,
      "threePointFieldGoalsAttempted": 694,
      "avgThreePointFieldGoalsAttempted": 10.844
     }
    },
    "player": "Luka Doncic",
    "playerId": 3945274,
    "position": "G",
    "teamName": "Lakers"
   },
   {
    "age": 28,
    "team": "OKC",
    "stats": {
     "general": {
      "fouls": 139,
      "minutes": 2259,
      "avgFouls": 2.044,
      "rebounds": 292,
      "ejections": 0,
      "avgMinutes": 33.221,
      "avgRebounds": 4.294,
      "gamesPlayed": 68,
      "doubleDouble": 8,
      "tripleDouble": 0,
      "flagrantFouls": 0,
      "technicalFouls": 3
     },
     "defensive": {
      "blocks": 52,
      "steals": 95,
      "avgBlocks": 0.765,
      "avgSteals": 1.397
     },
     "offensive": {
      "points": 2117,
      "assists": 448,
      "avgPoints": 31.132,
      "turnovers": 151,
      "avgAssists": 6.588,
      "avgTurnovers": 2.221,
      "fieldGoalPct": 55.337,
      "freeThrowPct": 87.948,
      "fieldGoalsMade": 731,
      "freeThrowsMade": 540,
      "avgFieldGoalsMade": 10.75,
      "avgFreeThrowsMade": 7.941,
      "fieldGoalsAttempted": 1321,
      "freeThrowsAttempted": 614,
      "avgFieldGoalsAttempted": 19.426,
      "avgFreeThrow
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nba-player-season-statistics-leaderboard-686a9c4f/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)