{"uid":"cap_yKs0eKBiH3i-qYLEpwlEX","slug":"nba-player-season-statistics-leaderboard-686a9c4f","name":"NBA Player Season Statistics Leaderboard","description":"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).","url":"https://api.fadeandco.workers.dev/api/dev/nba-stats?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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,"avgFreeThrowsAttempted":9.029,"threePointFieldGoalPct":38.591,"threePointFieldGoalsMade":115,"avgThreePointFieldGoalsMade":1.691,"threePointFieldGoalsAttempted":298,"avgThreePointFieldGoalsAttempted":4.382}},"player":"Shai Gilgeous-Alexander","playerId":4278073,"position":"G","teamName":"Thunder"}],"checkedAt":"2026-10-23T09:35:28.242Z","seasonType":"regular","seasonLabel":"2025-26","totalPlayers":578}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uE0dyhbkFCL7ZmjT9x73J","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Fantasy basketball player rankings","prompt":"Show me the top 50 NBA players ranked by assists for the 2025-26 regular season — I want per-game averages and totals so I can set my fantasy lineup."},{"title":"Playoff scoring leaders research","prompt":"Who are the top scorers in the 2025 NBA playoffs? Give me the first page sorted by points."},{"title":"Defensive stats deep dive","prompt":"Pull me the NBA leaderboard sorted by steals for the 2025-26 season, only qualified players, and show me their blocks and turnovers too."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:42.932Z","isFirstParty":false,"canonicalSlug":"nba-player-season-statistics-leaderboard-686a9c4f"}