COMO OS ALERTAS FUNCIONAM
Como uma queda de odds da API da Pinnacle se torna um alerta.
Um preço da Pinnacle cai na API de odds, e uma regra decide se você fica sabendo. Limiar percentual, janela de tempo, filtro de esporte, entrega: é isso que acontece entre o movimento e o alerta que sua aplicação recebe.
O que conta como queda na API de odds da Pinnacle
Uma queda é uma redução percentual dentro de uma janela de tempo móvel. Dois preços definem cada movimento: o preço antigo, em que a seleção era negociada no início da janela, e o preço novo, em que ela é negociada agora.
Queda = (antigo − novo) ÷ antigo × 100. Uma vitória da casa que vai de 2.10 para 1.95 caiu 7,1%. A forma percentual mantém a regra honesta em todo o quadro: a mesma queda de 0.15 é 10% em um favorito a 1.50 e só 1,4% em um azarão a 11.00. Ticks absolutos tratariam esses movimentos como iguais; sua regra não deveria.
O motor do feed executa esse teste dentro de sua própria janela de detecção e envia toda queda igual ou superior ao seu limite min_drop, a partir de 1%. A janela do motor é definida pelo serviço; uma janela mais longa, como as abaixo, é uma regra que você aplica aos alertas recebidos.
Uma janela própria deve ser móvel, não reiniciada. Não há candles nem intervalos fixos: com uma janela de dez minutos, cada preço recebido é testado contra o preço de dez minutos antes, não contra a virada da hora.
Escolhendo limites e janelas
Exemplo prático: uma regra de 5% em 10 minutos. Uma seleção desliza de 2.40 para 2.28 em nove minutos, o que dá (2.40 − 2.28) ÷ 2.40 = 5,0%, e o alerta dispara. Espalhe o mesmo movimento por 25 minutos e nada dispara: a janela é tão parte da regra quanto a porcentagem.
O dilema é sensibilidade contra ruído. Limites mais baixos e janelas mais curtas disparam com mais frequência: você pega os movimentos cedo, e também pega oscilações de um único tick em mercados pouco líquidos. Limites mais altos e janelas mais longas revelam menos reprecificações, mais deliberadas. Os dois são válidos; respondem a perguntas diferentes.
Um ponto de partida prático é mais largo do que o instinto sugere. Comece com 5% em 10 minutos em mercados pré-jogo, registre todo alerta em potencial por uma semana e depois aperte a regra onde o registro mostrar ruído. Seu mix de esportes decide o que é barulhento e o que é silencioso.
Filtrando por esporte e fase
Limites sozinhos não bastam, porque os esportes não se movem da mesma forma. Uma partida de tênis em andamento reprecifica a cada ponto, enquanto um mercado de longo prazo de futebol desliza por dias. Filtre antes de a regra rodar: esporte, liga e fase são os primeiros cortes habituais, e mantêm volume irrelevante longe da sua lógica de limites. O stream não tem parâmetro de esporte, então esse filtro vive no seu código, sobre o sport ou o sport_id de cada alerta. A fase já vem separada para você: quedas ao vivo e pré-jogo chegam em streams distintos.
A fase é o que mais importa. A maioria das aplicações roda ao vivo e pré-jogo como regras separadas, com limites separados, porque tamanho e cadência dos movimentos diferem muito entre os dois. Veja quedas ao vivo vs pré-jogo para saber o que muda entre os ritmos.
Para ver o que um limite significa em probabilidade e não em preço, a calculadora de odds em queda no pnclDATA transforma quaisquer dois preços na mudança que o mercado fez.
O que um evento de alerta carrega
Cada alerta é autossuficiente. Ele identifica a linha com sport, league, sect (o mercado, como Moneyline), outcome e period, carrega o preço antes e depois da queda como from_price e to_price, adiciona nvp, o preço justo sem margem após o movimento, e registra o horário do alerta em segundos Unix como alerted. Monte sua chave de deduplicação com id, sect, outcome, period e alerted juntos.
Isso basta para encaminhar, deduplicar e exibir um alerta sem uma segunda requisição. Quando uma decisão precisar do quadro completo, combine o stream com snapshots REST. Formato dos frames, reconexões e parsing são tratados no guia de configuração SSE.
Do alerta à ação
O alerta é uma entrada, não um sinal de aposta. Encaminhá-lo para uma notificação, um gatilho de modelo ou uma tela de monitoramento é trabalho do seu código; o trabalho do stream termina ao entregar eventos limpos.
Antes de conectar qualquer coisa, teste sua regra no papel contra movimentos de preço recentes e veja como um sinal percorre receber, filtrar, agir. Quando a regra se sustentar no papel, o stream de quedas entrega os eventos sobre os quais ela roda.