# Football-Data.co.uk Match Results & Odds

> Football-Data.co.uk Match Results & Odds 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 historical football match results, stats (shots, corners, cards, fouls), and betting odds (Bet365 + market average) for a given league and season from Football-Data.co.uk

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/football-data-couk?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/football-data-co-uk-match-results-odds-7e81fc1e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G4FNHxlwZEct86KJ0bg6b

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 football-data-co-uk-match-results-odds-7e81fc1e
```

Example prompt: Pull the last 20 Premier League matches from the current season involving Arsenal — I want the full-time scores, half-time scores, shots on target, and Bet365 1X2 odds for each game.

## When to prefer this

Choose this endpoint when you need structured historical or current-season football match data including scores, in-game statistics, and betting odds across 20 European leagues, particularly when you want both Bet365 prices and market averages in one call. Prefer this over scraping Football-Data.co.uk directly as it handles CSV parsing and returns clean JSON. Best for betting model research, team form analysis, referee analysis, or building sports dashboards.

## Known failure modes

- Missing required 'league' query parameter returns an error
- Invalid league code (not one of the 20 supported codes) returns an error or empty result
- Season not yet available in Football-Data.co.uk source returns empty matches array
- Team name misspelling (must match source spelling exactly, e.g. 'Man City' not 'Manchester City') returns zero results
- Limit outside 1-400 range may be clamped or rejected
- Payment failure (x402) if USDC balance is insufficient

## How this service works

European football match results with statistics and betting odds from Football-Data.co.uk (free CSV data): for a league and season — date, kick-off, teams, full-time and half-time score, result, referee, shots, shots on target, corners, fouls, cards, plus market average and Bet365 1X2 odds and average over/under 2.5 odds. 20 leagues (Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Süper Lig…). Filter by team.

## Output

A JSON object containing the league name, season, source URL, total match count, and an array of match results. Each match includes date, kick-off time, home and away team names, full-time and half-time scores and result (H/D/A), referee name, and a stats object (shots, shots on target, corners, fouls, yellow cards, red cards), plus an odds object with Bet365 home/draw/away prices, market average prices, and average over/under 2.5 odds. Also includes a checkedAt timestamp.

## 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": [
      "league"
     ],
     "properties": {
      "team": {
       "type": "string",
       "description": "Only matches of this team (as spelled by the source, e.g. Man City)"
      },
      "limit": {
       "type": "string",
       "description": "Matches, 1 to 400 (default 50), newest first"
      },
      "league": {
       "type": "string",
       "description": "League code: E0, E1, E2, E3, EC, SC0, SC1, D1, D2, I1, I2, SP1, SP2, F1, F2, N1, B1, P1, T1, G1 (E0 = Premier League)"
      },
      "season": {
       "type": "string",
       "description": "Season start year, e.g. 2025 for 2025/26 (default: current season)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "league": "E0",
  "season": "2025/2026",
  "source": "https://www.football-data.co.uk/mmz4281/2526/E0.csv",
  "matches": 38,
  "results": [
   {
    "away": "Arsenal",
    "date": "2026-05-24",
    "home": "Crystal Palace",
    "odds": {
     "bet365": {
      "away": 1.75,
      "draw": 4,
      "home": 4.2
     },
     "average": {
      "away": 1.76,
      "draw": 3.86,
      "home": 4.13
     },
     "over25Avg": 1.63,
     "under25Avg": 2.21
    },
    "time": "16:00",
    "stats": {
     "red": [
      0,
      0
     ],
     "fouls": [
      9,
      12
     ],
     "shots": [
      8,
      17
     ],
     "yellow": [
      0,
      1
     ],
     "corners": [
      3,
      4
     ],
     "shotsOnTarget": [
      3,
      7
     ]
    },
    "referee": "F Hallam",
    "fullTime": {
     "away": 2,
     "home": 1,
     "result": "A"
    },
    "halfTime": {
     "away": 1,
     "home": 0,
     "result": "A"
    }
   },
   {
    "away": "Burnley",
    "date": "2026-05-18",
    "home": "Arsenal",
    "odds": {
     "bet365": {
      "away": 23,
      "draw": 11,
      "home": 1.09
     },
     "average": {
      "away": 22.13,
      "draw": 10.12,
      "home": 1.08
     },
     "over25Avg": 1.33,
     "under25Avg": 3.19
    },
    "time": "20:00",
    "stats": {
     "red": [
      0,
      0
     ],
     "fouls": [
      7,
      16
     ],
     "shots": [
      13,
      5
     ],
     "yellow": [
      1,
      3
     ],
     "corners": [
      3,
      3
     ],
     "shotsOnTarget": [
      3,
      0
     ]
    },
    "referee": "P Tierney",
    "fullTime": {
     "away": 0,
     "home": 1,
     "result": "H"
    },
    "halfTime": {
     "away": 0,
     "home": 1,
     "result": "H"
    }
   }
  ],
  "checkedAt": "2026-10-23T09:35:28.009Z",
  "leagueName": "England Premier League"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/football-data-co-uk-match-results-odds-7e81fc1e/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)
