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.
Schnellstart
- Erstelle einen kostenlosen Key auf der API-Keys-Seite — jedes neue Konto startet mit 5 kostenlosen API-Calls.
- 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" - 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.
| Parameter | Beschreibung |
|---|---|
home + away | Die 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. |
fixture | Die 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. |
date | Optional, 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.
| Parameter | Beschreibung |
|---|---|
team | Teil des Teamnamens, z. B. team=Arsenal — trifft Heim- oder Auswärtsteam. |
league | ESPN-Key (eng.1) oder Liga-Slug (premier-league). |
date | Optional, YYYY-MM-DD (UTC). |
limit | Optional, 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.
| Parameter | Beschreibung |
|---|---|
name | Teil des Teamnamens, mind. 2 Zeichen, z. B. name=arsenal. |
league | Optionaler Filter, ESPN-Key oder Slug. |
limit | Optional, 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.
| Parameter | Beschreibung |
|---|---|
team | Filter per Teamname, z. B. team=Chelsea. |
league | ESPN-Key oder Slug. |
fixture | Einzelne Spiel-id. |
limit | Optional, 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.
| Plan | API access | Rate limit |
|---|---|---|
| Free | Predictions for the free leagues (top-5 leagues, Champions League, Europa League and all national-team competitions), fixtures, teams and results. | 10/min |
| Standard | Every league, plus full per-match depth data (score matrix, all O/U & BTTS lines, factor breakdown), predicted lineups and player goal probabilities. | 60/min |
| Pro | Everything in Standard, plus hot-match deep analysis, saved filters, high-confidence alerts and ledger CSV export. | 120/min |
| Ultra | Everything 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 |
Fehler
| HTTP | code | Bedeutung |
|---|---|---|
| 401 | E_INVALID_API_KEY | Unbekannter oder widerrufener Key. |
| 402 | E_INSUFFICIENT_CREDITS | Kostenkontingent und Credits aufgebraucht — siehe get_more. |
| 403 | E_KEY_SCOPE | Keys funktionieren nur auf den vier API-Endpunkten. |
| 403 | E_UPGRADE_REQUIRED | Your plan does not cover this league or feature. The body carries upgrade_to, unlocks and pricing_url — see Plans & API access. |
| 404 | E_PREDICTION_UNAVAILABLE | Keine offizielle Prognose für dieses Spiel (siehe Abdeckung oben). |
| 404 | E_TEAM_NOT_FOUND | Kein bewertetes Team entspricht der Abfrage. |
| 404 | E_RESULT_NOT_FOUND | Noch keine ausgewerteten Ergebnisse — offizielle Prognosen werden nach Spielende bewertet. |
| 422 | E_AMBIGUOUS_MATCH | Teamnamen trafen auf mehrere Spiele zu — füge date oder fixture hinzu. |
| 429 | E_RATE_LIMITED | Rate-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.