Quedas sem o stream: consultando o endpoint de drops

Nem todo mundo precisa de uma conexão mantida aberta. Se você quer ver quedas de preço recentes numa agenda em vez de em tempo real, o endpoint REST de drops as retorna como JSON puro, e um cron job que o chama a cada poucos minutos é um setup completo de alertas. Sem stream, sem plano com SSE, só uma consulta.

O que o endpoint retorna

O endpoint de drops te entrega os movimentos que o feed detectou nos últimos minutos, como o quickstart de curl descreve, verificado em 2026-10-18. Você escolhe ao vivo ou pré-jogo com o parâmetro mode, define o tamanho do movimento com min_drop_pct, e limita a idade com max_age_sec. Cada queda nomeia a partida, o mercado e o lado, e carrega os preços de antes e depois.

Uma chamada retorna uma janela limitada de histórico, não um feed ao vivo: você está lendo o que caiu recentemente, na sua agenda.

O padrão de consulta

A consulta é um cron job ou um timer que chama o endpoint e imprime o que há de novo:

curl -s -H "x-portal-apikey: $ODDS_API_KEY" \
  "$ODDS_BASE_URL/api/drops?mode=prematch&min_drop_pct=5&max_age_sec=300" \
  | jq '.drops[] | [.home, .away, .sect, .from_price, .to_price] | @tsv'

Mantenha a janela de idade um pouco mais larga que o seu intervalo de consulta, para que uma execução lenta nunca pule um movimento em silêncio, e guarde os ids de queda que você já viu para que cada um reporte uma vez.

O lado do orçamento

Esta é a parte que importa para a chave gratuita: o endpoint de drops é uma chamada REST, então gasta da mesma cota diária de 100 chamadas que a página de preços lista, verificado em 2026-10-18. Uma consulta a cada 15 minutos cabe na chave gratuita o dia todo com 96 chamadas, e te dá um resumo quarto-de-hora de toda queda além do seu limiar.

A cada minuto em vez de a cada quinze são 1.440 chamadas por dia e pertence a um plano pago, que a página de preços lista por taxa.

O que você abre mão

O stream empurra uma queda no momento em que é detectada; uma consulta a vê na próxima rodada. Para movimentos pré-jogo, onde a lacuna em outras casas dura minutos ou mais, o atraso raramente importa. Para movimentos ao vivo, importa, e essa é a linha honesta entre os dois: quedas que expiram em segundos pertencem ao stream, e todo o resto consulta bem.

Um endpoint, um timer, uma lista de deduplicação. O endpoint de drops é o irmão paciente do stream, e para uma vigia quarto-de-hora é tudo que você precisa.