Odds históricas para backtesting e modelos
Odds de fechamento das casas de apostas que você escolher, com o placar final incluído. Baixe a temporada inteira de uma liga em poucas requisições, ou um evento por vez, com a mesma API key que você usa para as odds ao vivo.
Última atualização
- Odds de fechamento desde
- dez. 2025
- Por requisição em lote
- 366 dias
- Casas de apostas por requisição
- 30
- Ligas por requisição
- 10
Um mês de odds de fechamento em uma só requisição
/v3/historical/closing-lines retorna todos os eventos liquidados do período com as odds de fechamento e o placar final. Eventos sem odds das suas casas de apostas também aparecem, com um objeto bookmakers vazio, para que uma odd ausente nunca pareça uma partida ausente.
curl "https://api.odds-api.io/v3/historical/closing-lines?apiKey=YOUR_API_KEY\
&sport=football&leagues=england-premier-league,spain-la-liga\
&from=2026-01-01T00:00:00Z&to=2026-01-31T23:59:59Z\
&markets=ML&bookmakers=Bet365,Unibet&limit=100"[
{
"id": 123456,
"home": "Arsenal",
"away": "Chelsea",
"date": "2026-01-14T20:00:00Z",
"status": "settled",
"league": { "name": "England - Premier League", "slug": "england-premier-league" },
"scores": { "home": 2, "away": 1 },
"bookmakers": {
"Bet365": [
{
"name": "ML",
"updatedAt": "2026-01-14T19:58:12Z",
"odds": [{ "home": "2.10", "draw": "3.40", "away": "3.60" }]
}
]
}
}
]Endpoints históricos
Quatro endpoints históricos e um para movimentação de linhas. A referência da API traz todos os parâmetros.
- GET
/v3/ historical/ closing-lines - Odds de fechamento de vários eventos de uma vez: até 10 ligas, 366 dias, 30 casas de apostas e os mercados que você indicar.Planos pagos
- GET
/v3/ historical/ odds - Odds de fechamento e placar final de um evento encerrado, para até 30 casas de apostas.Todos os planos
- GET
/v3/ historical/ events - Partidas liquidadas e placares finais de uma liga em um período de até 31 dias.Todos os planos
- GET
/v3/ historical/ events/ search - Eventos liquidados por nome do time em todas as ligas, dos mais recentes para os mais antigos.Todos os planos
- GET
/v3/ odds/ movements - Movimentação de linha pré-jogo de um mercado: a odd de abertura, a odd mais recente e as mudanças entre elas.Todos os planos
Baixe uma temporada em três passos
- 1
Escolha as ligas e as datas
Escolha um esporte, até 10 slugs de liga e um intervalo de datas de até 366 dias, para que uma temporada inteira caiba em uma só varredura.
- 2
Informe os mercados e as casas de apostas
markets e bookmakers são obrigatórios no endpoint em lote, com até 30 casas de apostas. Qualquer nome de /v3/bookmakers funciona, e as odds voltam com esse mesmo nome.
- 3
Percorra a temporada por páginas
Cada resposta traz até 100 eventos liquidados. Adicione skip até uma página voltar incompleta. Uma temporada de 240 partidas são três requisições.
O que os desenvolvedores constroem com ela
Faça backtest de um modelo de apostas
Rode um modelo sobre uma temporada passada e compare os preços dele com o fechamento de cada casa de apostas, com o placar final na mesma resposta.
Meça o closing line value
Compare a odd que você pegou com a de fechamento. O histórico de movimentação também traz a odd de abertura, então você vê o quanto a linha andou.
Monte um dataset de treinamento
Baixe as odds de fechamento de cinco ligas em uma temporada com cerca de 20 requisições em vez de cerca de 1.900 chamadas, uma por partida, em JSON que você carrega direto em um dataframe.
Profundidade dos dados e limites
As listas de eventos e as odds de fechamento em lote retornam apenas eventos liquidados. Os nomes de mercado são os mesmos que /v3/odds serve, então dados históricos e ao vivo se cruzam pelas mesmas chaves.
- Histórico de odds de fechamento
- Desde dezembro de 2025
- Intervalo de datas, odds de fechamento em lote
- 366 dias
- Intervalo de datas, eventos e busca
- 31 dias
- Ligas por requisição em lote
- 10
- Casas de apostas por requisição
- 30
- Eventos por resposta em lote
- 100, paginação com skip
- Formato
- JSON via REST
Perguntas frequentes sobre a API de odds históricas
Desde quando há dados históricos de odds?
As odds de fechamento estão disponíveis desde dezembro de 2025. Partidas e placares finais mais antigos continuam disponíveis em /v3/historical/events, mas os endpoints de odds retornam esses eventos com um objeto bookmakers vazio.
Qual endpoint devo usar para uma temporada inteira?
/v3/historical/closing-lines. Ele aceita até 10 ligas e 366 dias por requisição e retorna até 100 eventos liquidados por página. Baixar cinco ligas de uma temporada evento por evento dá cerca de 1.900 requisições; o endpoint em lote retorna os mesmos dados em cerca de 20.
Os dados históricos de odds estão incluídos no meu plano?
/v3/historical/events, /v3/historical/events/search e /v3/historical/odds estão disponíveis em todos os planos. /v3/historical/closing-lines exige um plano pago. Novas chaves gratuitas estão pausadas, então o Solo por £49/mês é a forma mais barata de começar.
Quais mercados e casas de apostas são cobertos?
As odds de fechamento são armazenadas para eventos liquidados em todas as casas de apostas e mercados que cobrimos. Os nomes de mercado dependem do esporte: a maioria usa ML, Totals e Spread, o tênis usa Totals (Games) e Spread (Games), e o beisebol escreve por extenso os cinco primeiros innings. Chame /v3/markets?sport=<sport> para ver os nomes exatos, e /v3/historical/odds sem filtro de markets para ver tudo o que um evento traz.
Vocês têm movimentação de linhas ou só odds de fechamento?
/v3/odds/movements retorna a odd de abertura, a odd mais recente e as mudanças entre elas para uma linha de mercado. O histórico é só pré-jogo e é registrado para uma lista fixa de casas de apostas, que a documentação traz completa. Está disponível em todos os planos.
Partidas não liquidadas ou canceladas estão incluídas?
/v3/historical/events, /v3/historical/events/search e /v3/historical/closing-lines listam apenas eventos liquidados, então uma partida encerrada que ainda não foi liquidada no nosso sistema não aparece ali. /v3/historical/odds retorna o status do evento, então confira. Para uma resposta explícita sobre cada evento, incluindo os cancelados, use a Bet Settlement API.
Comece seu backtest
Os dados históricos vêm com a mesma chave das odds ao vivo de 450+ casas de apostas. Planos a partir de £49/mês.