# NFL Fantasy x402 API – Player Usage & Opportunity Metrics

> NFL Fantasy x402 API – Player Usage & Opportunity Metrics is a paid API for AI agents from nfl-x402-api.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: GET https://nfl-x402-api.vercel.app/api/player/usage
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nfl-fantasy-x402-api-player-usage-opportunity-metrics-d5da7fae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_b8JD6YRXE6WQ0Kgyqlsyl

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 nfl-fantasy-x402-api-player-usage-opportunity-metrics-d5da7fae
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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": [],
     "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nfl-fantasy-x402-api-player-usage-opportunity-metrics-d5da7fae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nfl-x402-api.vercel.app](https://www.zero.xyz/host/nfl-x402-api.vercel.app/llms.txt)