DESARROLLADORES
API de predicción de fútbol — 1X2, Más/Menos de 2.5 y BTTS | Footalytics
API gratuita de predicción de fútbol: probabilidades de victoria/empate/derrota, más/menos de 2.5 y BTTS con niveles de confianza para la Premier League, La Liga, Bundesliga, Serie A, Ligue 1 y la Champions League. Respuestas JSON, 5 llamadas gratuitas y un servidor MCP para asistentes de IA.
Una API gratuita de predicción de fútbol para desarrolladores y asistentes de IA: respuestas JSON con probabilidades de victoria/empate/derrota, más/menos de 2.5, ambos equipos marcan, niveles de confianza y valoraciones de equipos para la Premier League, La Liga, Bundesliga, Serie A, Ligue 1, la Champions League y más. Las mismas predicciones se evalúan en nuestro registro público de precisión. Cuatro endpoints cubren todo el flujo: predecir un partido, explorar partidos, consultar valoraciones de equipos y leer resultados finalizados.
- 5 llamadas API gratuitas por cuenta — no se requiere tarjeta.
- JSON entra, probabilidades salen: 1X2, más/menos de 2.5, BTTS, marcadores probables y niveles de confianza.
- Servidor MCP incluido — los asistentes de IA se conectan directamente.
- Cada predicción se evalúa en público con puntuaciones Brier.
Precios — 5 llamadas API gratuitas por cuenta, sin tarjeta. Después, 1 crédito por llamada: los mismos créditos del chat del sitio, recargables en la página de precios. Sin cuota mensual.
Inicio rápido
- Crea una clave gratuita en la página de claves API — cada cuenta nueva empieza con 5 llamadas API gratuitas.
- Llama al endpoint con tu clave:
curl "https://footalytics.farvor.com/api/v1/predictions?home=Chelsea&away=Manchester%20United" \ -H "Authorization: Bearer fxk_your_key" - Lee la predicción:
{ "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" } }
Autenticación
Envía tu clave como token bearer en cada solicitud. La clave sin procesar se muestra una sola vez al crearla: guárdala de forma segura y nunca la incluyas en el control de código fuente. Revócala y vuelve a crearla en cualquier momento en la página de claves API.
Authorization: Bearer fxk_your_key
GET /api/v1/predictions
Una llamada exitosa cuesta 1 unidad. Las consultas fallidas no cuestan nada.
| Parámetro | Descripción |
|---|---|
home + away | La forma fácil. Nombres de equipos, p. ej. home=Chelsea&away=Manchester United (codifica los espacios en URL como %20). Se resuelve mediante la ventana de partidos en vivo de 14 días; si coinciden varios partidos, se sirve el que tenga una predicción publicada. |
fixture | La forma precisa, cuando ya conoces el id: cualquiera de 401879248, ESPN-401879248 o ESPN-eng.1-401879248. Es la única forma de acceder a partidos que ya comenzaron. |
date | Opcional, YYYY-MM-DD (UTC) — distingue las revanchas. |
{
"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"
}
}
Cobertura: las predicciones oficiales se publican hasta 48 horas antes del inicio. Se cubren todos los partidos de la Premier League, La Liga, Bundesliga, Serie A, Ligue 1 y Champions League, además de los enfrentamientos más destacados de otras ligas. La búsqueda por nombre de equipo cubre los partidos aún por disputarse en la ventana de partidos en vivo; para partidos que ya comenzaron, pasa el id del partido.
GET /api/v1/fixtures
Próximos partidos con sus ids de partido — la mitad de descubrimiento del flujo: encuentra el partido aquí (has_prediction te dice si ya hay una predicción publicada) y luego llama a predictions. Se factura exactamente igual que predictions.
| Parámetro | Descripción |
|---|---|
team | Subcadena del nombre del equipo, p. ej. team=Arsenal — coincide con local o visitante. |
league | Clave ESPN (eng.1) o slug de liga (premier-league). |
date | Opcional, YYYY-MM-DD (UTC). |
limit | Opcional, predeterminado 20, máx. 50. |
Se requiere al menos uno de team / league.
curl "https://footalytics.farvor.com/api/v1/fixtures?league=eng.1&limit=3" \
-H "Authorization: Bearer fxk_your_key"
Respuesta:{
"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
Perfiles de equipos de nuestra tabla de valoraciones: la valoración estilo Elo detrás de cada predicción.
| Parámetro | Descripción |
|---|---|
name | Subcadena del nombre del equipo, mín. 2 caracteres, p. ej. name=arsenal. |
league | Filtro opcional, clave ESPN o slug. |
limit | Opcional, predeterminado 20, máx. 50. |
Se requiere al menos uno de name / league.
curl "https://footalytics.farvor.com/api/v1/teams?name=arsenal" \
-H "Authorization: Bearer fxk_your_key"
Respuesta:{
"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
El registro finalizado: marcadores reales junto a lo que predijo nuestro modelo, evaluado mercado por mercado — las mismas filas sobre las que se construye el registro público de precisión.
| Parámetro | Descripción |
|---|---|
team | Filtro por nombre de equipo, p. ej. team=Chelsea. |
league | Clave ESPN o slug. |
fixture | Un solo id de partido. |
limit | Opcional, predeterminado 10, máx. 20. |
Se requiere al menos uno de team / league / fixture.
curl "https://footalytics.farvor.com/api/v1/results?team=Chelsea&limit=3" \
-H "Authorization: Bearer fxk_your_key"
Respuesta:{
"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"
}
}
]
}
Créditos y límites de uso
La API tiene su propia asignación gratuita: 5 llamadas en cualquier endpoint — predictions, fixtures, teams, results — concedidas una vez por cuenta. Después, los créditos (los mismos créditos comprados que se usan en el chat del sitio) cobran cada llamada exitosa; las consultas fallidas no cuestan nada. Los créditos gratuitos de predicción del sitio son independientes y solo funcionan en el chat del sitio. Cada respuesta incluye x-credits-remaining y x-credits-used para que quienes llaman puedan vigilar el saldo.
Límite de frecuencia: 30 llamadas por minuto por clave. Cuando se agota el saldo, la API responde 402 indicando la recarga:
{
"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 |
Errores
| HTTP | code | Significado |
|---|---|---|
| 401 | E_INVALID_API_KEY | Clave desconocida o revocada. |
| 402 | E_INSUFFICIENT_CREDITS | Asignación gratuita y créditos agotados — consulta get_more. |
| 403 | E_KEY_SCOPE | Las claves solo funcionan en los cuatro endpoints de la API. |
| 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 | No hay predicción oficial para este partido (consulta la cobertura arriba). |
| 404 | E_TEAM_NOT_FOUND | Ningún equipo valorado coincide con la consulta. |
| 404 | E_RESULT_NOT_FOUND | Aún no coincide ningún resultado finalizado — las predicciones oficiales se evalúan tras el final del partido. |
| 422 | E_AMBIGUOUS_MATCH | Los nombres de equipo coincidieron con varios partidos — añade date o fixture. |
| 429 | E_RATE_LIMITED | Límite de frecuencia alcanzado — reinténtalo tras la pausa indicada en Retry-After. |
MCP — conecta asistentes de IA
Los asistentes de IA (Claude, ChatGPT, Cursor, …) pueden llamar las mismas predicciones a través del Model Context Protocol. Apunta cualquier cliente MCP a:
https://footalytics.farvor.com/mcp
Conéctate con una clave API como token bearer, o mediante autorización OAuth con un clic — el cliente se registra solo y pide consentimiento en el navegador. Herramientas: get_match_prediction, list_fixtures, get_team, list_results (todas comparten la misma asignación) y get_account_credits (gratuita).
Skill — Claude Code y agentes
¿Prefieres un archivo a un conector? Instala la skill compatible con Agent-Skills y tu agente llamará los mismos cuatro endpoints por sí mismo — misma clave, misma asignación. Descárgala directamente de nosotros (no necesitas GitHub):
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
…o un solo archivo si tu agente solo necesita el contrato:curl -fsSL https://footalytics.farvor.com/skill/SKILL.md -o SKILL.md
Descarga con un clic (zip, mismos archivos):footalytics-skill.zip
Deja que tu IA lo instale
Copia este prompt y envíalo a tu asistente de IA — instalará la skill por ti:
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.
El prompt indica a tu asistente que obtenga la skill del host de esta página, la coloque en la carpeta correcta y te pida la clave API. No se ejecuta nada más.
Atribución
Cuando compartas o muestres resultados, mantén “Predictions by Footalytics” con un enlace al sitio. Las predicciones son probabilidades estadísticas, no certezas.