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.

Recargar créditos Obtén una clave API gratuita →

Inicio rápido

  1. Crea una clave gratuita en la página de claves API — cada cuenta nueva empieza con 5 llamadas API gratuitas.
  2. 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"
  3. 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ámetroDescripción
home + awayLa 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.
fixtureLa 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.
dateOpcional, 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ámetroDescripción
teamSubcadena del nombre del equipo, p. ej. team=Arsenal — coincide con local o visitante.
leagueClave ESPN (eng.1) o slug de liga (premier-league).
dateOpcional, YYYY-MM-DD (UTC).
limitOpcional, 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ámetroDescripción
nameSubcadena del nombre del equipo, mín. 2 caracteres, p. ej. name=arsenal.
leagueFiltro opcional, clave ESPN o slug.
limitOpcional, 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ámetroDescripción
teamFiltro por nombre de equipo, p. ej. team=Chelsea.
leagueClave ESPN o slug.
fixtureUn solo id de partido.
limitOpcional, 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.

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 →

Errores

HTTPcodeSignificado
401E_INVALID_API_KEYClave desconocida o revocada.
402E_INSUFFICIENT_CREDITSAsignación gratuita y créditos agotados — consulta get_more.
403E_KEY_SCOPELas claves solo funcionan en los cuatro endpoints de la API.
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_UNAVAILABLENo hay predicción oficial para este partido (consulta la cobertura arriba).
404E_TEAM_NOT_FOUNDNingún equipo valorado coincide con la consulta.
404E_RESULT_NOT_FOUNDAún no coincide ningún resultado finalizado — las predicciones oficiales se evalúan tras el final del partido.
422E_AMBIGUOUS_MATCHLos nombres de equipo coincidieron con varios partidos — añade date o fixture.
429E_RATE_LIMITEDLí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.