Notas de quickstart
Por que a sua consulta de odds retorna um board vazio
Um 200 com um array de eventos vazio é uma resposta válida, não um bug. As quatro causas comuns, e como provar que o board está vivo em duas chamadas.
Você chama o endpoint de mercados e recebe um 200 com um array de eventos vazio. Isso é uma resposta válida, não um feed quebrado: o envelope traz events mais o cursor last, como o quickstart de curl mostra, e um array vazio simplesmente significa que este board não tem nada agora. O trabalho é descobrir por quê, e há quatro suspeitos de sempre.
O board é real e está quieto
Um board de futebol ao vivo às 6 da manhã pode estar vazio porque nada está rolando. Um board pré-jogo numa semana de off-season pode estar vazio porque nada está agendado. Esta é a causa mais comum e a mais fácil de confirmar: a mesma chamada retorna eventos algumas horas depois, quando há partidas.
Antes de depurar qualquer outra coisa, confira a hora e o calendário do esporte que você pediu.
Você pediu o esporte errado
O endpoint seleciona por ID de esporte, e a página inicial lista os treze IDs de esporte que o feed precifica. Um erro de digitação, ou um ID copiado do mapeamento de outro sistema, retorna um board vazio válido para sempre. Imprima o ID que você enviou e compare com a lista documentada antes de culpar o feed.
Você pediu a fase errada
Ao vivo e pré-jogo são chamadas separadas com o mesmo formato, e um board pode estar vazio numa fase enquanto cheio na outra. O lado pré-jogo recebe o parâmetro event_type, como o quickstart de Sheets usa, verificado em 2026-10-10. Se o seu board está vazio, chame a outra fase: a diferença entre as duas respostas te diz em qual board seus jogos estão.
Você se filtrou para o vazio
Se você filtra eventos por liga ou time no seu próprio código, um filtro com uma string errada não retorna nada num board cheio. Teste a resposta sem filtro primeiro; se ela vier cheia, o bug está no seu filtro, não na API.
Prove em duas chamadas
O teste de duas chamadas resolve todo board vazio. Primeiro, chame um esporte que você sabe que tem partidas hoje, ao vivo se estiver jogando, pré-jogo se não estiver. Se chegarem eventos, a API e a sua chave estão bem, e o vazio pertence ao board ou ao timing da primeira chamada. Segundo, confira os códigos de status quando as coisas falham: as notas do quickstart de curl sobre o que os outros status significam distinguem um 200 vazio válido de uma falha de autenticação ou de limite de taxa, que parecem completamente diferentes.
Um board vazio é uma resposta sobre o board, não sobre o seu código. Prove a vivacidade com um esporte ocupado, depois confira fase, ID de esporte e seus próprios filtros, nessa ordem.