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.
Início rápido
- Crie uma chave gratuita na página de chaves API — cada conta nova começa com 5 chamadas API gratuitas.
- 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" - 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âmetro | Descrição |
|---|---|
home + away | A 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. |
fixture | A 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. |
date | Opcional, 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âmetro | Descrição |
|---|---|
team | Substring do nome da equipe, ex. team=Arsenal — corresponde a mandante ou visitante. |
league | Chave ESPN (eng.1) ou slug da liga (premier-league). |
date | Opcional, YYYY-MM-DD (UTC). |
limit | Opcional, 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âmetro | Descrição |
|---|---|
name | Substring do nome da equipe, mín. 2 caracteres, ex. name=arsenal. |
league | Filtro opcional, chave ESPN ou slug. |
limit | Opcional, 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âmetro | Descrição |
|---|---|
team | Filtro por nome de equipe, ex. team=Chelsea. |
league | Chave ESPN ou slug. |
fixture | Um único id de jogo. |
limit | Opcional, 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.
| 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 |
Erros
| HTTP | code | Significado |
|---|---|---|
| 401 | E_INVALID_API_KEY | Chave desconhecida ou revogada. |
| 402 | E_INSUFFICIENT_CREDITS | Cota gratuita e créditos esgotados — veja get_more. |
| 403 | E_KEY_SCOPE | As chaves só funcionam nos quatro endpoints da 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 | Sem previsão oficial para esta partida (veja a cobertura acima). |
| 404 | E_TEAM_NOT_FOUND | Nenhuma equipe avaliada corresponde à consulta. |
| 404 | E_RESULT_NOT_FOUND | Ainda não há resultados finalizados correspondentes — as previsões oficiais são avaliadas após o apito final. |
| 422 | E_AMBIGUOUS_MATCH | Os nomes das equipes corresponderam a vários jogos — adicione date ou fixture. |
| 429 | E_RATE_LIMITED | Limite 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.