{"uid":"cap_LUluGrUml8w-XT8hNf6KD","slug":"nfl-fantasy-x402-api-player-stats-a9fedb23","name":"NFL Fantasy x402 API – Player Stats","description":"NFL player weekly or season fantasy football stats (2015-2025) with points computed to any custom scoring: PPR, half-PPR, standard, TE premium, 6-pt pass TD, or full JSON overrides.","url":"https://nfl-x402-api.vercel.app/api/player/stats","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","required":[],"properties":{"agg":{"enum":["weekly","season"],"type":"string","default":"weekly"},"name":{"type":"string","description":"Player name (used if player_id omitted)"},"weeks":{"type":"string","description":"Single week (5) or range (3-8)"},"preset":{"enum":["ppr","half_ppr","standard","ppr_6pt_pass","te_premium"],"type":"string","default":"ppr"},"scoring":{"type":"string","description":"JSON scoring overrides, e.g. {\"pass_td\":6,\"rec\":0.5}"},"seasons":{"type":"string","description":"CSV of seasons, e.g. 2024,2025. Defaults to previous+latest seasons in the DB."},"player_id":{"type":"string","description":"nflverse GSIS player id"},"season_type":{"enum":["REG","POST","ALL"],"type":"string","default":"REG"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_70-OhJ7Z8gIShLjRXHukf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns NFL player weekly or season fantasy football stats with points computed using customizable scoring systems (PPR, half-PPR, standard, TE premium, 6-pt pass TD, or JSON overrides)","exampleAgentPrompt":"What were Tyreek Hill's PPR fantasy points week by week during the 2024 regular season?","exampleUseCases":[{"title":"Draft preparation scoring comparison","prompt":"Show me half-PPR fantasy points for the top 5 running backs in the 2024 season so I can decide who to target in my draft."},{"title":"Trade value evaluation mid-season","prompt":"Give me Patrick Mahomes' 6-point pass TD scoring stats for weeks 1 through 8 this year so I can figure out if trading for him makes sense."},{"title":"Custom league scoring analysis","prompt":"I need Kelce's season fantasy totals using our league's custom scoring: 1.5 PPR for RBs, 1 PPR for WRs, and 2 points per reception for TEs—can you pull that for 2024?"}],"resultDescription":"A JSON object containing the player's fantasy football stats and computed fantasy points for the requested season(s) and week(s), calculated using the specified scoring preset (e.g. PPR, half-PPR) or custom scoring overrides, with weekly or season-level aggregation as requested.","failureModes":["Player not found by name or player_id — returns empty result or error","Invalid season range (outside 2015–2025) — returns error or empty data","Malformed scoring JSON override — returns validation error","Invalid week range format — returns error","No data available for specified season_type (e.g. POST with no playoff games) — returns empty result"],"whenToPreferThis":"Use this endpoint when you need fantasy football points or underlying stats for a specific NFL player, especially when you want flexible scoring (PPR, half-PPR, standard, TE premium, 6-pt pass TDs, or fully custom JSON overrides) across any season from 2015–2025, either weekly or season-level. Prefer this over generic sports stats APIs when fantasy point computation is needed rather than raw box score data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:39:56.797Z","isFirstParty":false}