Notas de quickstart
Quando mover seu script do polling para o stream de quedas
Se o seu loop de polling existe para detectar quedas de preço, o stream de quedas já faz esse trabalho. Os sinais de que você deve mudar, e o que você perde.
O ponto de virada é fácil de ver no seu próprio código: se o seu loop de polling gasta a maioria das linhas comparando snapshots consecutivos para achar quedas de preço, você está reimplementando uma detecção que o stream de quedas já faz. Mova essa parte para o stream. Mantenha o polling só para aquilo a que ele realmente serve: estado completo do board numa agenda.
O sinal no seu próprio código
Abra o seu poller e conte as linhas que não têm nada a ver com buscar. Se a maior parte do trabalho depois de cada resposta é comparar o board novo com o antigo, guardar só as quedas e aplicar um limiar, seu script é um detector de quedas com um problema de polling anexado. Cada linha desse diff é código que o stream apaga.
O outro sinal é o descompasso de cadência. Você faz polling cada vez mais rápido para pegar os movimentos mais cedo, e cada passo de frequência multiplica requisições enquanto sua taxa de acerto fica plana.
O que o stream te dá
Uma requisição HTTP que fica aberta, e uma linha data: para cada lote de quedas igual ou acima do seu min_drop, como o quickstart de Python mostra o mesmo ouvinte. A detecção acontece no lado do feed: a queda, o limiar e o momento são decididos antes de o alerta chegar a você. Seu código encolhe para parsear, filtrar, reagir.
A primeira linha que você recebe é um objeto de controle, e ela dobra como checagem de plano: uma chave cujo plano não tem stream recebe plan_lacks_sse em vez de alertas, segundo o mesmo quickstart, verificado em 2026-10-03.
O que você abre mão
O stream só envia quedas. Ele não vai te contar o preço que não se moveu, o board de uma partida de que você de repente precisa, ou o estado atual depois de um reinício. Se a sua aplicação renderiza boards completos ou alimenta um modelo que precisa de cada seleção, mantenha o loop de polling para o estado e deixe o stream cuidar dos movimentos.
Muitos projetos terminam com os dois: um poller lento para o estado, o stream para os movimentos. A página de preços lista quais planos incluem o stream e quais são só polling, verificado em 2026-10-03, então a combinação que você escolhe é tanto uma decisão de plano quanto de código.
A migração em uma tarde
Mantenha o poller rodando, adicione o ouvinte de stream ao lado, e registre os dois por um dia. Quando os alertas do stream baterem com os movimentos que o seu diff acharia, apague o diff. O código de busca, o tratamento de cursor e os caminhos de erro que você já tem passam sem mudança.
Polling para estado, stream para movimento. O dia em que a sua lógica de diff desaparece é o dia em que a integração ficou mais simples e mais rápida ao mesmo tempo.