# Understat xG Player Stats

> Understat xG Player Stats 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 top players by expected goals (xG) for a given football league and season, including goals, xG, assists, xA, shots, key passes, and minutes played.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/understat-xg?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/understat-xg-player-stats-716ad0f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kP3yKyakO-jLu_-GpbzmR

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 understat-xg-player-stats-716ad0f3
```

Example prompt: Can you pull the top 25 Premier League players by expected goals for the 2024-25 season from Understat, including their actual goals, assists, xA, shots, key passes, and minutes?

## When to prefer this

Use this endpoint when you need structured, per-player xG and xA statistics for a specific European football league and season. It is the right choice when the goal is to rank or compare players by expected performance metrics rather than just raw goals. Prefer this over general sports APIs when Understat's model-based xG data is specifically required for analysis, scouting, or fantasy football purposes.

## Known failure modes

- Invalid league name returns an error or empty result
- Season year outside 2014–2026 range may return an error
- Limit outside 1–50 range may be rejected or clamped
- Understat source unavailable causes upstream fetch failure
- Very recent season data may be incomplete or missing

## How this service works

Understat expected-goals (xG) player stats for one league and season: top players by xG with goals, xG, assists, xA, shots, key passes and minutes. Leagues: EPL, La_liga, Bundesliga, Serie_A, Ligue_1, RFPL. Season is the start year (2025 = 2025-26).

## Output

A ranked list of players (up to the requested limit) from the specified league and season, each with their name, goals scored, xG, assists, xA, shot count, key passes, and minutes played — sourced from Understat data.

## 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": {
      "limit": {
       "type": "string",
       "description": "How many players, 1 to 50 (default 10)"
      },
      "league": {
       "type": "string",
       "description": "EPL (default), La_liga, Bundesliga, Serie_A, Ligue_1 or RFPL"
      },
      "season": {
       "type": "string",
       "description": "Season start year, 2014 to 2026 (default 2025)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/understat-xg-player-stats-716ad0f3/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)