Menu da documentação
Documentação
Probabilidades e confronto direto
Probabilidades pré-jogo, odds justas, gols esperados, over/under, ambos marcam e médias de confronto direto.
Os endpoints /prediction e /h2h fazem parte dos planos ULTRA e MEGA e estão disponíveis para os jogos dos próximos 7 dias. Os valores são recalculados a cada hora. Quando ainda não há cálculo para a partida, a resposta é 404.
Probabilidades pré-jogo
GET /v1/matches/{match_id}/prediction
| Campo | Conteúdo |
|---|---|
result.home_win, result.draw, result.away_win |
Probabilidade e odd justa de cada resultado |
expected_goals.home, expected_goals.away |
Gols esperados de cada time |
over_under |
Probabilidade de mais de 0.5, 1.5, 2.5, 3.5 e 4.5 gols |
btts_yes |
Probabilidade de ambos marcarem |
most_likely_scores |
Placares exatos ordenados por probabilidade |
{
"data": {
"computed_at": "2026-11-07T15:00:03Z",
"expected_goals": { "home": 1.16, "away": 1.78 },
"result": {
"home_win": { "probability": 0.2505, "fair_odds": 3.99 },
"draw": { "probability": 0.276, "fair_odds": 3.62 },
"away_win": { "probability": 0.4735, "fair_odds": 2.11 }
},
"over_under": {
"over_0_5": 0.9308,
"over_1_5": 0.8081,
"over_2_5": 0.5632,
"over_3_5": 0.3393,
"over_4_5": 0.1748
},
"btts_yes": 0.5871,
"most_likely_scores": [
{ "score": "1-1", "probability": 0.1255 },
{ "score": "1-2", "probability": 0.0971 },
{ "score": "0-2", "probability": 0.0837 }
]
}
}
Como as probabilidades são calculadas
Nosso modelo estatístico estima quantos gols cada time deve marcar, considerando a força de ataque e de defesa de cada equipe, e calcula a probabilidade de cada placar. Os mercados de resultado, over/under e ambos marcam são obtidos a partir dessas probabilidades.
As previsões são estimativas estatísticas e não garantem resultados.
Odd justa
A odd justa é o inverso da probabilidade, sem a margem da casa de apostas:
odd justa = 1 / probabilidade
0.4735 → 1 / 0.4735 = 2.11
Se o mercado paga mais do que a odd justa, o preço está acima do que o modelo estima. Se paga menos, está abaixo. As casas de apostas embutem uma margem nas odds, então em geral as odds de mercado ficam abaixo das odds justas.
Confronto direto
GET /v1/matches/{match_id}/h2h
| Bloco | Conteúdo |
|---|---|
summary |
Número de encontros, vitórias de cada lado, empates e média de gols de cada time |
team_averages.home e team_averages.away |
Médias recentes por jogo: gols marcados e sofridos, posse, finalizações, finalizações no alvo, escanteios, faltas, cartões amarelos e vermelhos e xG |
{
"data": {
"summary": { "matches": 8, "home_wins": 1, "draws": 2, "away_wins": 5, "home_goals_avg": 0.62, "away_goals_avg": 2.25 },
"team_averages": {
"home": { "matches": 9, "goals_scored": 0.67, "possession": 47.56, "shots": 16.89, "corners": 4.67, "yellow_cards": 2.22, "xg": 1.63 },
"away": { "matches": 9, "goals_scored": 2.22, "possession": 64.11, "shots": 15.33, "corners": 6.0, "yellow_cards": 1.44, "xg": 2.04 }
}
}
}
As médias são úteis para mercados de escanteios, cartões e finalizações, que não aparecem na previsão.