{"uid":"cap_b8JD6YRXE6WQ0Kgyqlsyl","slug":"nfl-fantasy-x402-api-player-usage-opportunity-metrics-d5da7fae","name":"NFL Fantasy x402 API – Player Usage & Opportunity Metrics","description":"NFL player usage and opportunity metrics for fantasy football: target share, air yards share, WOPR, Next Gen Stats (separation, YAC over expectation, rush yards over expected) with recent-week trend deltas vs season average.","url":"https://nfl-x402-api.vercel.app/api/player/usage","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":{"name":{"type":"string","description":"Player name (used if player_id omitted)"},"last_n":{"type":"string","default":"4","description":"Trailing-week window size"},"season":{"type":"string","description":"Season year. Defaults to the latest season present in the DB."},"player_id":{"type":"string","description":"nflverse GSIS player id"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YPsB_tP9G_-T3lWlCa5lr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns NFL player usage and opportunity metrics (target share, air yards share, WOPR, Next Gen Stats) with recent-week trend deltas vs season average for fantasy football analysis.","exampleAgentPrompt":"What are the usage and opportunity metrics for Davante Adams over the last 4 weeks in the 2025 season — I want target share, air yards share, WOPR, and how his recent numbers compare to his season average?","exampleUseCases":[{"title":"Waiver wire pickup evaluation metrics","prompt":"I'm thinking about picking up this running back off waivers — can you pull his rush yards over expected and recent trend data to see if his opportunity is actually increasing or just a one-week fluke?"},{"title":"Start-sit decision for fantasy matchup","prompt":"Should I start CeeDee Lamb this week? Pull his target share, air yards share, and separation metrics for the last two weeks and tell me how those stack up against his season average."},{"title":"Trade deadline player comparison analysis","prompt":"I'm deciding between two receivers in a trade — one is averaging 18% target share with high WOPR, the other is at 12% but trending up. Can you show me both their air yards share and next gen stats plus how they've trended over the last month?"}],"resultDescription":"A JSON object containing the player's target share, air yards share, WOPR, Next Gen Stats (separation, YAC over expectation, rush yards over expected), and trend deltas showing how their last N weeks compare to their full-season averages.","failureModes":["Player not found if name is misspelled or player_id is invalid — returns 404 or empty result","Insufficient data if player has fewer games than the requested last_n window","Season parameter mismatch if requesting a season with no available data","Missing metrics for certain positions (e.g., air yards not applicable for RBs)","Payment failure if x402 USDC payment is not properly authorized"],"whenToPreferThis":"Use this endpoint when you need detailed opportunity and efficiency metrics for NFL skill-position players for fantasy football decision-making, especially when you want trend analysis comparing recent weeks to season averages. Prefer this over generic stats endpoints when WOPR, air yards share, or Next Gen Stats (separation, rush yards over expected) are specifically needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:28.477Z","isFirstParty":false}