BestsOddsApi — Cobertura: casas, esportes e mercados

Este documento lista tudo o que a fonte de dados da BestsOddsApi oferece: casas de aposta, esportes e mercados, além de quais mercados são liquidados nos resultados (para fechar bilhetes).

Levantamento feito em 17/10/2026 com chamadas reais à fonte de dados. As contagens de eventos são uma fotografia daquele momento e mudam o tempo todo.

Leia antes: um mercado listado nem sempre tem odds

As listas abaixo mostram os mercados que podem existir para um esporte. Isso não garante que todo jogo terá odds em todos eles, nem o tempo todo. Um mercado pode vir sem odds, ou sumir e voltar, por motivos normais da operação da casa de aposta:

• Nível do jogo e da liga. Ligas grandes (La Liga, Premier League, NBA) recebem dezenas ou centenas de mercados. Ligas menores, categorias de base e amistosos costumam ter só os principais (vencedor, handicap, total).
• Momento do jogo. Muitos mercados abrem só perto do início (por exemplo, mercados de jogador dependem da escalação). Outros fecham durante a partida: "1º gol" some depois do primeiro gol, mercados do 1º tempo encerram no intervalo, e mercados de janela de minutos ("próximos 10 minutos") abrem e fecham continuamente.
• Suspensões ao vivo. Em lances perigosos, gols, pênaltis, cartões e revisões de VAR a casa suspende os mercados por alguns segundos. A API entrega a seleção com suspended: true e price: null até a reabertura.
• Decisão da casa. A casa pode retirar um mercado a qualquer momento (risco, informação nova, limite de exposição).
• Ao vivo é diferente do pré-jogo. O conjunto de mercados ao vivo é próprio e muda de acordo com o placar e o tempo de jogo.

Na amostra de futebol pré-jogo abaixo, por exemplo, 128 mercados estavam listados para Real Betis x Barcelona, mas só 39 tinham odds naquele momento. A coluna "Tinha odds na amostra" mostra isso.

Como tratar no seu sistema: nunca assuma que um mercado existe. Mostre o que chegou, trate suspended: true como "temporariamente indisponível" e considere o campo stale dos snapshots.

1. Casas de aposta

Ativa hoje

Disponíveis para ativação

Estas casas são oferecidas pela fonte de dados e podem ser ativadas por configuração. Para elas a fonte entrega apenas os mercados principais: vencedor (1X2 / moneyline), handicap asiático e total (over/under). Algumas casas publicam só o vencedor. O catálogo completo de mercados existe apenas para a bet365.

Casas que tinham odds no jogo de amostra (Real Betis x Barcelona, La Liga):

Outras casas suportadas pela fonte, sem odds nesse jogo específico (a presença varia por liga e região): Betclic, Betdaq, Betfred, Betsson, Bet-at-home, BetVictor, Betway, HKJC, Intertops, Marsbet, Nitrogen Sports, PaddyPower, Polymarket, SkyBet, VirginBet, FanDuel.

Cada casa ativada é uma consulta a mais por jogo a cada atualização. Ativar muitas casas aumenta o consumo de cota da plataforma.

2. Esportes

A fonte oferece 28 esportes no catálogo de eventos, todos já mapeados na BestsOddsApi. Hoje estão ligados futebol, basquete e tênis; os demais podem ser ligados por configuração.

Esportes que aparecem apenas no ao vivo da bet365 e ainda não estão no catálogo da BestsOddsApi: Golfe, Pool (sinuca americana), Trote (corrida de charrete) e Esportes virtuais.

Esportes sazonais (futebol americano, beisebol, futebol australiano, críquete) variam muito ao longo do ano. "Sem leitura" significa que a consulta não retornou dados no levantamento.

3. Mercados

3.1 Como os mercados chegam na API

Cada odd traz market (código do mercado), selection_key (a seleção) e line (linha de handicap ou total, quando existe). Há dois tipos de código:

1. Códigos padronizados (tabela 3.2): os mercados mais usados têm código e seleções fixos, iguais em todas as casas, no pré-jogo e no ao vivo. São também os mercados liquidados nos resultados (seção 4).
2. Demais mercados da bet365: market = bet365_ + nome do mercado (listas da seção 3.3), com nomes de times trocados por home/away e sem o placar entre parênteses do ao vivo (Asian Handicap (0-1) ⇒ asian_handicap). A selection_key é montada com os rótulos da seleção (ex.: score_lamine_yamal_away, home_over + line), também com home/away no lugar dos times. Quando dois rótulos ficam iguais, o id da seleção na casa é acrescentado ao final.

Regras gerais:

• line de handicap é sempre na perspectiva do mandante (home): asian_handicap com line = -0.750 significa mandante −0,75 / visitante +0,75. Linhas divididas (0.0,-0.5) chegam como a média (-0.250).
• Preços sempre em decimal com 4 casas (1.8696); o ao vivo da bet365, publicado em fração, é convertido.
• Seleção suspensa: suspended: true (com o último preço conhecido, quando houver).
• Os nomes dos mercados genéricos podem diferir entre pré-jogo e ao vivo (a casa usa nomes diferentes nas duas fases); os padronizados não.

3.2 Mercados padronizados

Nas outras casas (seção 1) só existem match_winner, asian_handicap e over_under (e, para basquete, as variantes de tempo e quarto quarter_moneyline, quarter_spread, quarter_over_under).

3.3 Catálogo completo da bet365

As listas abaixo vêm de jogos reais consultados em 17/10/2026 e mostram os nomes dos mercados como a bet365 publica. O market na API é bet365_ + esse nome, exceto os que viram código padronizado (tabela 3.2). Por exemplo, full_time_result ⇒ match_winner, goal_line ⇒ over_under e shots_on_target ⇒ bet365_shots_on_target.

• Cada lista vem de um jogo de amostra por esporte. Outros jogos podem ter mais ou menos mercados (veja "Leia antes" no início do documento).
• jogador, {mandante} e {visitante} substituem nomes de atletas e de times.

Pedidos mais comuns no futebol:

Futebol — pré-jogo (amostra: Real Betis x Barcelona, La Liga — 128 mercados, 39 com odds)

Principais

Gols

Tempos (1º/2º)

Linhas asiáticas

Escanteios

Cartões e faltas

Jogadores — gols/assistências

Jogadores — finalizações

Jogadores — estatísticas

Outros / especiais

Futebol — ao vivo (amostra: Everton x Chelsea, Premier League — 77 mercados, 1.141 preços)

Ao vivo a bet365 publica o nome do mercado; os mercados de janela de tempo ("próximo minuto", "próximos 10 minutos") são abertos e fechados continuamente durante a partida.

Basquete — pré-jogo (50 mercados na amostra)

Tênis — pré-jogo (26 mercados na amostra)

Hóquei no gelo — pré-jogo (44 mercados na amostra)

Beisebol — pré-jogo (41 mercados na amostra)

Vôlei — pré-jogo (13 mercados na amostra)

Handebol — pré-jogo (10 mercados na amostra)

Tênis de mesa — pré-jogo (10 mercados na amostra)

E-sports — pré-jogo (11 mercados na amostra)

Críquete — pré-jogo (8 mercados na amostra)

MMA/UFC — pré-jogo (1 mercado na amostra)

Boxe — pré-jogo (1 mercado na amostra)

MMA e boxe: no jogo de amostra só o mercado de vencedor estava publicado. Em lutas principais de grandes eventos a bet365 costuma abrir também método de vitória e round, mas isso não foi visto neste levantamento.

4. Resultados e liquidação (fechar bilhetes)

GET /api/v1/events/{id}/results e GET /api/v1/results?date=AAAA-MM-DD trazem, além do placar, o bloco markets com o resultado de cada seleção dos mercados liquidados. O mesmo conteúdo chega por WebSocket no evento result.updated (canal do evento e canal ao vivo do esporte).

"markets": [
  {"market": "match_winner", "line": null, "selections": {"home": "won", "draw": "lost", "away": "lost"}, "others": null},
  {"market": "asian_handicap", "line": "-0.750", "selections": {"home": "half_won", "away": "half_lost"}, "others": null},
  {"market": "correct_score", "line": null, "selections": {"2-1": "won"}, "others": "lost"}
]

• others: resultado das seleções que não aparecem na lista. No placar exato só o placar vencedor é listado; todos os outros são lost.
• Mercados com linha trazem um item por linha que teve odds no evento, inclusive linhas que mudaram durante o jogo.

Mercados liquidados:

Observações:

• Escanteios só são liquidados quando a estatística do jogo chega da fonte; sem ela o mercado não aparece (nunca é estimado).
• Handicap asiático e goal line ao vivo são cotados sobre o restante do jogo a partir do placar do momento da aposta (o nome do mercado traz o placar, ex. (0-1)). A liquidação da API vale para o jogo inteiro (a partir de 0-0); para apostas ao vivo nesses mercados, desconte o placar do momento da aposta.
• Mercados genéricos (bet365_*) não são liquidados pela API.
• Resultados ficam disponíveis por 5 dias após o fim do jogo (purge_after).

5. WebSocket: uma conexão por esporte

Peça o ticket com o esporte: POST /api/v1/ws/authorize com {"sport": "soccer"}. A conexão aceita apenas os canais desse esporte e tem limites próprios:

• max_ws_connections do plano vale por esporte;
• cada conexão aceita até max_subscriptions canais (padrão 100: 100 jogos por esporte por conexão).

Exemplo: um plano com 1 conexão e 100 assinaturas permite 100 jogos de futebol, 100 de basquete e 100 de tênis ao mesmo tempo (3 conexões, uma por esporte). Sem sport, a conexão aceita todos os esportes do plano e usa um limite de conexões separado.

O canal ao vivo do esporte (private-customer.{id}.live.{sport}) traz status, placar e tempo de todos os jogos ao vivo e os result.updated de todos os jogos encerrados. As odds de cada jogo chegam pelo canal do jogo (private-customer.{id}.event.{eventId}.odds).

6. Odds ao vivo: ligas cobertas

As odds ao vivo (atualização de odds e placar a cada ~1 s) cobrem uma lista selecionada de competições. O pré-jogo continua cobrindo todas as ligas. Jogos ao vivo de outras ligas seguem disponíveis na API (status, placar a cada ~10 s e resultado), sem atualização de odds ao vivo.

Futebol:

• 1ª e 2ª divisão e principais copas nacionais de Brasil (também a Série C), Inglaterra, Espanha, Itália, Alemanha, França, Portugal, Holanda, Argentina e Turquia;
• 1ª divisão dos demais países;
• Competições continentais: Champions League, Europa League, Conference League, Libertadores, Sul-Americana, Recopa Sul-Americana, AFC Champions League Elite, CAF Champions League, CONCACAF Champions Cup e Mundial de Clubes;
• Seleções: Copa do Mundo e eliminatórias, Eurocopa, Copa América, Nations League, Copa Africana de Nações e Copa Asiática;
• Feminino: Brasileirão Feminino A1, Women's Champions League, WSL e NWSL;
• Base: apenas Mundial Sub-20 e Mundial Sub-17.

Ficam fora do ao vivo: partidas virtuais e e-soccer, amistosos de clubes, ligas amadoras, regionais e de divisões inferiores. Jogos de futebol com o cronômetro parado (intervalo, antes do início ou aguardando o apito final) não são atualizados até o cronômetro voltar a correr.

Basquete:

• Principais ligas nacionais de Estados Unidos, Brasil, Espanha, Itália, Alemanha, França, Turquia, Argentina, Grécia, Israel, Lituânia, Sérvia, Austrália, China, Japão, Coreia do Sul, Filipinas, Polônia, Bélgica e Holanda (BNXT League);
• 2ª divisão somente de Brasil (Liga Ouro), Espanha (Primera FEB), Itália (Serie A2), Alemanha (ProA), França (Élite 2), Turquia (TBL) e Argentina (Liga Argentina);
• Estados Unidos: NBA (incluindo a NBA Cup), NBA G League e NCAA Division I;
• Copas nacionais: apenas as principais dos países acima;
• Competições internacionais: EuroLeague, EuroCup, Basketball Champions League, FIBA Europe Cup, Liga Adriática (ABA), BCL Americas, Liga Sul-Americana, Basketball Africa League, BCL Asia, FIBA Intercontinental Cup, Copa do Mundo FIBA e eliminatórias, EuroBasket, AmeriCup, Asia Cup, AfroBasket e Jogos Olímpicos;
• Feminino: WNBA e as principais competições internacionais (EuroLeague Women, EuroCup Women, Copa do Mundo, EuroBasket e Jogos Olímpicos).

Os demais países e ligas, as categorias de base e as competições de baixa relevância ficam fora do ao vivo e podem ser habilitados individualmente sob demanda.

Tênis: todas as competições.

Frequência de atualização: jogos acompanhados por clientes conectados ao WebSocket e jogos das ligas prioritárias são atualizados a cada ~1 s; os demais jogos ao vivo cobertos, a cada ~3 s; jogos sem nenhum mercado aberto no momento (tudo suspenso), a cada ~10 s até os mercados reabrirem.

As listas são configuráveis por competição: ligas podem ser incluídas ou removidas conforme a demanda dos clientes.

7. Resumo