ENTWICKLER

Fußball-Prognose-API — 1X2, Über/Unter 2.5 & BTTS | Footalytics

Kostenlose Fußball-Prognose-API: Wahrscheinlichkeiten für Sieg/Unentschieden/Niederlage, Über/Unter 2.5 und BTTS mit Konfidenzstufen für Premier League, La Liga, Bundesliga, Serie A, Ligue 1 und Champions League. JSON-Antworten, 5 kostenlose Calls und ein MCP-Server für KI-Assistenten.

Eine kostenlose Fußball-Prognose-API für Entwickler und KI-Assistenten: JSON-Antworten mit Wahrscheinlichkeiten für Sieg/Unentschieden/Niederlage, Über/Unter 2.5, beide Teams treffen, Konfidenzstufen und Team-Ratings für Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League und mehr. Dieselben Prognosen werden in unserer öffentlichen Genauigkeitsbilanz bewertet. Vier Endpunkte decken den gesamten Ablauf ab — ein Spiel prognostizieren, Spiele durchsuchen, Team-Ratings nachschlagen und ausgewertete Ergebnisse lesen.

  • 5 kostenlose API-Calls pro Konto — keine Karte erforderlich.
  • JSON rein, Wahrscheinlichkeiten raus: 1X2, Über/Unter 2.5, BTTS, wahrscheinliche Ergebnisse und Konfidenzstufen.
  • MCP-Server inklusive — KI-Assistenten verbinden sich direkt.
  • Jede Prognose wird öffentlich mit Brier-Scores bewertet.

Preise — 5 kostenlose API-Aufrufe pro Konto, keine Karte nötig. Danach 1 Credit pro Aufruf — dieselben Credits wie im Website-Chat, auf der Preisseite aufladbar. Keine Monatsgebühr.

Credits aufladen Kostenlosen API-Key holen →

Schnellstart

  1. Erstelle einen kostenlosen Key auf der API-Keys-Seite — jedes neue Konto startet mit 5 kostenlosen API-Calls.
  2. Rufe den Endpunkt mit deinem Key auf:
    curl "https://footalytics.farvor.com/api/v1/predictions?home=Chelsea&away=Manchester%20United" \
      -H "Authorization: Bearer fxk_your_key"
  3. Lies die Prognose:
    {
      "provider": "Footalytics",
      "match": {
        "id": "ESPN-401879248", "home": "Chelsea", "away": "Manchester United",
        "league": "Premier League", "kickoff_utc": "2026-10-31T12:30:00Z", "status": "pending"
      },
      "prediction": {
        "outcome": { "home": 0.474, "draw": 0.267, "away": 0.259, "pick": "home" },
        "confidence": "medium",
        "xg": { "home": 1.61, "away": 1.13 },
        "top_scores": [{ "score": "1-1", "p": 0.127 }, { "score": "2-1", "p": 0.094 }],
        "over_2_5": 0.55, "btts": 0.52
      },
      "result": null,
      "links": {
        "match_page": "/match/401879248-chelsea-vs-manchester-united",
        "share": "https://footalytics.farvor.com/p/x4affkwufz2c",
        "accuracy": "https://footalytics.farvor.com/accuracy"
      }
    }

Authentifizierung

Sende deinen Key bei jeder Anfrage als Bearer-Token. Der Roh-Key wird nur einmal bei der Erstellung angezeigt — speichere ihn sicher und committe ihn nie in die Quellcodeverwaltung. Widerrufe und erstelle ihn jederzeit neu auf der API-Keys-Seite.

Authorization: Bearer fxk_your_key

GET /api/v1/predictions

Ein erfolgreicher Call kostet 1 Einheit. Fehlgeschlagene Abfragen kosten nichts.

ParameterBeschreibung
home + awayDie einfache Methode. Teamnamen, z. B. home=Chelsea&away=Manchester United (Leerzeichen als %20 URL-codieren). Aufgelöst über das Live-Spielfenster von 14 Tagen; bei mehreren Treffern wird das Spiel mit veröffentlichter Prognose bereitgestellt.
fixtureDie präzise Methode, wenn du die id bereits kennst — eine von 401879248, ESPN-401879248 oder ESPN-eng.1-401879248. Nur so erreichst du Spiele, die bereits angepfiffen wurden.
dateOptional, YYYY-MM-DD (UTC) — unterscheidet Rückspiele.
{
  "provider": "Footalytics",
  "match": {
    "id": "ESPN-401879248", "home": "Chelsea", "away": "Manchester United",
    "league": "Premier League", "kickoff_utc": "2026-10-31T12:30:00Z", "status": "pending"
  },
  "prediction": {
    "outcome": { "home": 0.474, "draw": 0.267, "away": 0.259, "pick": "home" },
    "confidence": "medium",
    "xg": { "home": 1.61, "away": 1.13 },
    "top_scores": [{ "score": "1-1", "p": 0.127 }, { "score": "2-1", "p": 0.094 }],
    "over_2_5": 0.55, "btts": 0.52
  },
  "result": null,
  "links": {
    "match_page": "/match/401879248-chelsea-vs-manchester-united",
    "share": "https://footalytics.farvor.com/p/x4affkwufz2c",
    "accuracy": "https://footalytics.farvor.com/accuracy"
  }
}

Abdeckung: Offizielle Prognosen werden bis zu 48 Stunden vor Anpfiff veröffentlicht. Jedes Spiel der Premier League, La Liga, Bundesliga, Serie A, Ligue 1 und Champions League ist abgedeckt, plus die stärksten Paarungen anderer Ligen. Die Suche per Teamname deckt Spiele ab, die im Live-Spielfenster noch bevorstehen — für bereits angepfiffene Spiele übergib die Spiel-id.

GET /api/v1/fixtures

Kommende Spiele mit ihren Spiel-ids — die Entdeckungshälfte des Ablaufs: Finde das Spiel hier (has_prediction zeigt, ob bereits eine Prognose veröffentlicht ist), rufe dann predictions auf. Abrechnung exakt wie predictions.

ParameterBeschreibung
teamTeil des Teamnamens, z. B. team=Arsenal — trifft Heim- oder Auswärtsteam.
leagueESPN-Key (eng.1) oder Liga-Slug (premier-league).
dateOptional, YYYY-MM-DD (UTC).
limitOptional, Standard 20, max. 50.

Mindestens eines von team / league ist erforderlich.

curl "https://footalytics.farvor.com/api/v1/fixtures?league=eng.1&limit=3" \
  -H "Authorization: Bearer fxk_your_key"
Antwort:
{
  "provider": "Footalytics",
  "fixtures": [
    {
      "fixture": "ESPN-401879251", "home": "AFC Bournemouth", "away": "Leeds United",
      "competition": "Premier League", "kickoff_utc": "2026-10-31T15:00Z",
      "has_prediction": false,
      "links": { "match_page": "/match/401879251-afc-bournemouth-vs-leeds-united" }
    }
  ]
}

GET /api/v1/teams

Teamprofile aus unserer Rating-Tabelle: das Elo-artige Rating hinter jeder Prognose.

ParameterBeschreibung
nameTeil des Teamnamens, mind. 2 Zeichen, z. B. name=arsenal.
leagueOptionaler Filter, ESPN-Key oder Slug.
limitOptional, Standard 20, max. 50.

Mindestens eines von name / league ist erforderlich.

curl "https://footalytics.farvor.com/api/v1/teams?name=arsenal" \
  -H "Authorization: Bearer fxk_your_key"
Antwort:
{
  "provider": "Footalytics",
  "teams": [
    {
      "id": "359", "name": "Arsenal", "league": "eng.1", "league_name": "Premier League",
      "rating": 1971, "games": 27, "ratings_updated_at": "2026-10-28T13:00:23Z"
    }
  ]
}

GET /api/v1/results

Die ausgewertete Bilanz: echte Ergebnisse neben dem, was unser Modell prognostiziert hat, Markt für Markt bewertet — dieselben Zeilen, auf denen die öffentliche Genauigkeitsbilanz basiert.

ParameterBeschreibung
teamFilter per Teamname, z. B. team=Chelsea.
leagueESPN-Key oder Slug.
fixtureEinzelne Spiel-id.
limitOptional, Standard 10, max. 20.

Mindestens eines von team / league / fixture ist erforderlich.

curl "https://footalytics.farvor.com/api/v1/results?team=Chelsea&limit=3" \
  -H "Authorization: Bearer fxk_your_key"
Antwort:
{
  "provider": "Footalytics",
  "results": [
    {
      "fixture": "ESPN-401878764", "home": "Sunderland", "away": "Leeds United",
      "competition": "Premier League", "kickoff_utc": "2026-10-25T16:30:00Z",
      "result": { "home_goals": 0, "away_goals": 0 },
      "our_prediction": {
        "outcome": { "home": 0.398, "draw": 0.277, "away": 0.326, "pick": "home" },
        "confidence": "low", "actual": "draw",
        "hit_1x2": false, "hit_over_2_5": false, "hit_btts": false, "brier": 0.787
      },
      "links": {
        "match_page": "/match/401878764-sunderland-vs-leeds-united",
        "share": "https://footalytics.farvor.com/p/vny7wa2tabh4"
      }
    }
  ]
}

Credits & Limits

Die API hat ihr eigenes kostenloses Kontingent: 5 Calls auf jedem Endpunkt — predictions, fixtures, teams, results — einmal pro Konto gewährt. Danach belasten Credits (dieselben gekauften Credits wie im Site-Chat) jeden erfolgreichen Call; fehlgeschlagene Abfragen kosten nichts. Die kostenlosen Prognose-Credits der Website sind getrennt und funktionieren nur im Site-Chat. Jede Antwort enthält x-credits-remaining und x-credits-used, damit Aufrufer den Saldo verfolgen können.

Rate-Limit: 30 Calls pro Minute pro Key. Ist das Guthaben aufgebraucht, antwortet die API mit 402 und verweist aufs Aufladen:

{
  "error": {
    "code": "E_INSUFFICIENT_CREDITS",
    "message": "You've used all 5 free API calls and your credits.",
    "get_more": [ { "method": "purchase", "url": "https://footalytics.farvor.com/pricing" } ]
  }
}

Plans & API access by tier

The four prediction endpoints above work on every plan. Subscription tiers widen what the API returns — the same entitlements as in site chat, enforced per call. A call your plan does not cover answers 403 E_UPGRADE_REQUIRED with upgrade_to (the tier that unlocks it), unlocks (one line on what that tier adds) and pricing_url, so clients can route users straight to the right plan.

PlanAPI accessRate limit
FreePredictions for the free leagues (top-5 leagues, Champions League, Europa League and all national-team competitions), fixtures, teams and results.10/min
StandardEvery league, plus full per-match depth data (score matrix, all O/U & BTTS lines, factor breakdown), predicted lineups and player goal probabilities.60/min
ProEverything in Standard, plus hot-match deep analysis, saved filters, high-confidence alerts and ledger CSV export.120/min
UltraEverything in Pro, plus the batch predictions endpoint (POST /api/v1/predictions/batch, up to 20 matches per call), full ledger + own-history export and high-confidence strategy tracking.300/min

See plans & pricing →

Fehler

HTTPcodeBedeutung
401E_INVALID_API_KEYUnbekannter oder widerrufener Key.
402E_INSUFFICIENT_CREDITSKostenkontingent und Credits aufgebraucht — siehe get_more.
403E_KEY_SCOPEKeys funktionieren nur auf den vier API-Endpunkten.
403E_UPGRADE_REQUIREDYour plan does not cover this league or feature. The body carries upgrade_to, unlocks and pricing_url — see Plans & API access.
404E_PREDICTION_UNAVAILABLEKeine offizielle Prognose für dieses Spiel (siehe Abdeckung oben).
404E_TEAM_NOT_FOUNDKein bewertetes Team entspricht der Abfrage.
404E_RESULT_NOT_FOUNDNoch keine ausgewerteten Ergebnisse — offizielle Prognosen werden nach Spielende bewertet.
422E_AMBIGUOUS_MATCHTeamnamen trafen auf mehrere Spiele zu — füge date oder fixture hinzu.
429E_RATE_LIMITEDRate-Limit erreicht — nach der Pause in Retry-After erneut versuchen.

MCP — KI-Assistenten verbinden

KI-Assistenten (Claude, ChatGPT, Cursor, …) können dieselben Prognosen über das Model Context Protocol aufrufen. Richte einen beliebigen MCP-Client auf:

https://footalytics.farvor.com/mcp
Verbinde dich mit einem API-Key als Bearer-Token oder per OAuth-Ein-Klick-Autorisierung — der Client registriert sich selbst und fragt im Browser um Zustimmung. Tools: get_match_prediction, list_fixtures, get_team, list_results (alle teilen dasselbe Kontingent) und get_account_credits (kostenlos).

Skill — Claude Code & Agenten

Datei statt Connector? Installiere den Agent-Skills-kompatiblen Skill, und dein Agent ruft dieselben vier Endpunkte selbst auf — gleicher Key, gleiches Kontingent. Direkt von uns herunterladen (kein GitHub nötig):

mkdir -p ~/.claude/skills/footalytics && cd ~/.claude/skills/footalytics
for f in SKILL.md README.md README.zh-CN.md; do
  curl -fsSL "https://footalytics.farvor.com/skill/$f" -o "$f"
done
…oder eine Datei, wenn dein Agent nur den Vertrag braucht:
curl -fsSL https://footalytics.farvor.com/skill/SKILL.md -o SKILL.md
Ein-Klick-Download (zip, gleiche Dateien):footalytics-skill.zip

Lass deine KI es installieren

Kopiere diesen Prompt und sende ihn an deinen KI-Assistenten — er installiert den Skill für dich:

Install the "Footalytics" skill for me.

1. Download these three files from https://footalytics.farvor.com/skill/ and save them in
   ~/.claude/skills/footalytics/ (create the folder if needed):
   - SKILL.md
   - README.md
   - README.zh-CN.md
   Use curl or any fetch tool, e.g.:
   curl -fsSL https://footalytics.farvor.com/skill/SKILL.md -o SKILL.md
2. Read the installed SKILL.md and follow its Setup section: check whether the
   FOOTALYTICS_API_KEY environment variable is set. If it is not, ask me to create
   a free key at https://footalytics.farvor.com/api-keys and help me set it
   (e.g. export FOOTALYTICS_API_KEY="fxk_...").
3. When done, confirm what you installed and ask me for a football match to
   predict as a test. Do NOT invent match probabilities yourself - always use
   the Footalytics API per the skill.

Der Prompt weist deinen Assistenten an, den Skill vom Host dieser Seite zu holen, ihn im richtigen Ordner abzulegen und dich nach dem API-Key zu fragen. Sonst wird nichts ausgeführt.

Namensnennung

Wenn du Ergebnisse teilst oder anzeigst, behalte “Predictions by Footalytics” mit einem Link zur Website bei. Prognosen sind statistische Wahrscheinlichkeiten, keine Gewissheiten.