DESENVOLVEDORES

API de Previsão de Futebol — 1X2, Mais/Menos de 2.5 & BTTS | Footalytics

API gratuita de previsão de futebol: probabilidades de vitória/empate/derrota, mais/menos de 2.5 e BTTS com níveis de confiança para Premier League, La Liga, Bundesliga, Serie A, Ligue 1 e Champions League. Respostas JSON, 5 chamadas gratuitas e um servidor MCP para assistentes de IA.

Uma API gratuita de previsão de futebol para desenvolvedores e assistentes de IA: respostas JSON com probabilidades de vitória/empate/derrota, mais/menos de 2.5, ambas as equipes marcam, níveis de confiança e avaliações de equipes para Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League e mais. As mesmas previsões são avaliadas em nosso registro público de precisão. Quatro endpoints cobrem todo o fluxo: prever uma partida, explorar jogos, consultar avaliações de equipes e ler resultados finalizados.

  • 5 chamadas API gratuitas por conta — sem necessidade de cartão.
  • JSON entra, probabilidades saem: 1X2, mais/menos de 2.5, BTTS, placares prováveis e níveis de confiança.
  • Servidor MCP incluído — assistentes de IA conectam direto.
  • Cada previsão é avaliada publicamente com pontuações Brier.

Preços — 5 chamadas de API gratuitas por conta, sem cartão. Depois, 1 crédito por chamada — os mesmos créditos do chat do site, recarregáveis na página de preços. Sem mensalidade.

Recarregar créditos Obtenha uma chave API gratuita →

Início rápido

  1. Crie uma chave gratuita na página de chaves API — cada conta nova começa com 5 chamadas API gratuitas.
  2. Chame o endpoint com sua chave:
    curl "https://footalytics.farvor.com/api/v1/predictions?home=Chelsea&away=Manchester%20United" \
      -H "Authorization: Bearer fxk_your_key"
  3. Leia a previsão:
    {
      "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"
      }
    }

Autenticação

Envie sua chave como token bearer em cada solicitação. A chave bruta é exibida uma única vez na criação — guarde-a com segurança e nunca a inclua no controle de código-fonte. Revogue e recrie a qualquer momento na página de chaves API.

Authorization: Bearer fxk_your_key

GET /api/v1/predictions

Uma chamada bem-sucedida custa 1 unidade. Consultas com falha não custam nada.

ParâmetroDescrição
home + awayA forma fácil. Nomes das equipes, ex. home=Chelsea&away=Manchester United (codifique os espaços em URL como %20). Resolvido pela janela de jogos ao vivo de 14 dias; se vários jogos coincidirem, será servido o que tiver previsão publicada.
fixtureA forma precisa, quando você já conhece o id — qualquer um de 401879248, ESPN-401879248 ou ESPN-eng.1-401879248. É a única forma de acessar partidas que já começaram.
dateOpcional, YYYY-MM-DD (UTC) — desambigua revanches.
{
  "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: as previsões oficiais são publicadas até 48 horas antes do início. Todos os jogos da Premier League, La Liga, Bundesliga, Serie A, Ligue 1 e Champions League são cobertos, além dos confrontos mais fortes de outras ligas. A busca por nome de equipe cobre jogos ainda por vir na janela de jogos ao vivo — para jogos que já começaram, passe o id do jogo.

GET /api/v1/fixtures

Próximos jogos com seus ids de jogo — a metade de descoberta do fluxo: encontre a partida aqui (has_prediction indica se uma previsão já foi publicada) e depois chame predictions. Cobrado exatamente como predictions.

ParâmetroDescrição
teamSubstring do nome da equipe, ex. team=Arsenal — corresponde a mandante ou visitante.
leagueChave ESPN (eng.1) ou slug da liga (premier-league).
dateOpcional, YYYY-MM-DD (UTC).
limitOpcional, padrão 20, máx. 50.

É necessário pelo menos um de team / league.

curl "https://footalytics.farvor.com/api/v1/fixtures?league=eng.1&limit=3" \
  -H "Authorization: Bearer fxk_your_key"
Resposta:
{
  "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

Perfis de equipes da nossa tabela de avaliações: a avaliação estilo Elo por trás de cada previsão.

ParâmetroDescrição
nameSubstring do nome da equipe, mín. 2 caracteres, ex. name=arsenal.
leagueFiltro opcional, chave ESPN ou slug.
limitOpcional, padrão 20, máx. 50.

É necessário pelo menos um de name / league.

curl "https://footalytics.farvor.com/api/v1/teams?name=arsenal" \
  -H "Authorization: Bearer fxk_your_key"
Resposta:
{
  "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

O registro finalizado: placares reais ao lado do que nosso modelo previu, avaliado mercado por mercado — as mesmas linhas que compõem o registro público de precisão.

ParâmetroDescrição
teamFiltro por nome de equipe, ex. team=Chelsea.
leagueChave ESPN ou slug.
fixtureUm único id de jogo.
limitOpcional, padrão 10, máx. 20.

É necessário pelo menos um de team / league / fixture.

curl "https://footalytics.farvor.com/api/v1/results?team=Chelsea&limit=3" \
  -H "Authorization: Bearer fxk_your_key"
Resposta:
{
  "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 e limites

A API tem sua própria cota gratuita: 5 chamadas em qualquer endpoint — predictions, fixtures, teams, results — concedidas uma vez por conta. Depois disso, os créditos (os mesmos créditos comprados usados no chat do site) cobram cada chamada bem-sucedida; consultas com falha não custam nada. Os créditos gratuitos de previsão do site são separados e só funcionam no chat do site. Cada resposta traz x-credits-remaining e x-credits-used para que os chamadores acompanhem o saldo.

Limite de taxa: 30 chamadas por minuto por chave. Quando o saldo acaba, a API responde 402 apontando para a 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 →

Erros

HTTPcodeSignificado
401E_INVALID_API_KEYChave desconhecida ou revogada.
402E_INSUFFICIENT_CREDITSCota gratuita e créditos esgotados — veja get_more.
403E_KEY_SCOPEAs chaves só funcionam nos quatro endpoints da 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_UNAVAILABLESem previsão oficial para esta partida (veja a cobertura acima).
404E_TEAM_NOT_FOUNDNenhuma equipe avaliada corresponde à consulta.
404E_RESULT_NOT_FOUNDAinda não há resultados finalizados correspondentes — as previsões oficiais são avaliadas após o apito final.
422E_AMBIGUOUS_MATCHOs nomes das equipes corresponderam a vários jogos — adicione date ou fixture.
429E_RATE_LIMITEDLimite de taxa atingido — tente novamente após a pausa em Retry-After.

MCP — conecte assistentes de IA

Assistentes de IA (Claude, ChatGPT, Cursor, …) podem chamar as mesmas previsões pelo Model Context Protocol. Aponte qualquer cliente MCP para:

https://footalytics.farvor.com/mcp
Conecte-se com uma chave API como token bearer, ou via autorização OAuth com um clique — o cliente se registra sozinho e pede consentimento no navegador. Ferramentas: get_match_prediction, list_fixtures, get_team, list_results (todas compartilham a mesma cota) e get_account_credits (gratuita).

Skill — Claude Code e agentes

Prefere um arquivo a um conector? Instale a skill compatível com Agent-Skills e seu agente chamará os mesmos quatro endpoints sozinho — mesma chave, mesma cota. Baixe direto de nós (sem precisar do 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
…ou um arquivo, se seu agente só precisa do contrato:
curl -fsSL https://footalytics.farvor.com/skill/SKILL.md -o SKILL.md
Download com um clique (zip, mesmos arquivos):footalytics-skill.zip

Deixe sua IA instalar

Copie este prompt e envie ao seu assistente de IA — ele instalará a skill para você:

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.

O prompt diz ao seu assistente para buscar a skill no host desta página, colocá-la na pasta certa e pedir sua chave API. Nada mais é executado.

Atribuição

Ao compartilhar ou exibir resultados, mantenha “Predictions by Footalytics” com um link para o site. Previsões são probabilidades estatísticas, não certezas.