Ciclo de Vida do Mercado: Suspensões e Remoções

Mercados saem do quadro o tempo todo — uma casa suspende após um gol, retira uma linha de handicap ou total quando a linha principal se move, ou liquida o evento. A SharpAPI sinaliza cada uma dessas transições explicitamente em todas as superfícies de consumo. Você nunca precisa inferir que um mercado fechou esperando o preço parecer obsoleto.

Esta página é o mapa: qual sinal dispara quando, em qual superfície, e como manter seu estado local limpo.

As Duas Formas de um Mercado Sair do QuadroPermalink for this section

As casas de apostas retiram mercados do quadro de duas maneiras distintas, e a SharpAPI espelha ambas fielmente:

Matriz de Sinais por SuperfíciePermalink for this section

Se você faz polling do /odds simples, a remoção é comunicada por ausência: compare cada snapshot com o anterior e remova as linhas cujos ids não aparecem mais. Funciona, mas obriga você a calcular o diff — para avisos de remoção explícitos, use o /odds/delta (seu array removed[] nomeia cada id retirado desde o seu último poll) ou o stream (push, sem polling algum).

Escadas de Linhas: Handicaps e TotaisPermalink for this section

Mercados de handicap (spread) e total são escadas — um conjunto de degraus em linhas diferentes (-2.5, -3, -3.5, …; O/U 2.25, 2.5, 2.75, …). Quando a linha principal se move, as casas — a Pinnacle em particular — retiram os degraus nos limiares antigos e publicam novos. Cada degrau é sua própria linha de odds com seu próprio id, então:

• Um degrau retirado (o mercado de limiar que desaparece) dispara odds:removed / aparece em removed[], exatamente como qualquer outra remoção.
• O degrau novo chega como uma linha nova via odds:update (ou no próximo snapshot/delta), com os flags is_main_line / is_alternate_line indicando onde ele se posiciona na escada.
• Um degrau que retorna (comum no jogo ao vivo — as casas recentralizam as escadas constantemente) chega novamente sob o mesmo id determinístico.

O giro da escada é intenso durante o jogo ao vivo: degraus alternativos vêm e vão muitas vezes por partida. Trate uma remoção como “fora do quadro agora”, não como um fechamento terminal — somente a liquidação do evento é definitiva.

total 2.5 (id …_total_over_2.5)   ── a linha se move para 3 ──▶  odds:removed [..._total_over_2.5]
                                                                 odds:update  [..._total_over_3]   (degrau novo)

Padrão de cliente recomendadoPermalink for this section

Indexe seu estado local pelo id da odd e aplique três regras, em ordem de eventos:

1. odds:update (ou uma linha em data[]) → upsert da linha.
2. odds:removed (ou um id em removed[]) → deletar a linha.
3. is_active: false → manter a linha mas marcá-la como não apostável (esmaecê-la); uma reabertura chega como um odds:update normal com is_active: true e um preço novo.

# Delta-polling loop: explicit removals, no client-side diffing
since = initial_timestamp
while True:
    r = get(f"/api/v1/odds/delta?since={since}&sportsbook=pinnacle").json()
    for row in r["data"]:
        local_state[row["id"]] = row          # upsert (covers is_active flips)
    for gone in r.get("removed", []):
        local_state.pop(gone["id"], None)     # delete — the close signal
    since = r["meta"]["server_time"]
    sleep(5)

// SSE: push-based, the same three rules
es.addEventListener('odds:update', (e) => {
  for (const row of JSON.parse(e.data).odds) localState.set(row.id, row);
});
es.addEventListener('odds:removed', (e) => {
  for (const id of JSON.parse(e.data).ids) localState.delete(id);
});

Preços Congelados e Proteções contra Preços ObsoletosPermalink for this section

Dois flags no nível da linha protegem você de agir sobre um preço que a casa não está mais honrando:

Os próprios motores de EV e arbitragem da SharpAPI excluem pernas com is_active: false, então os endpoints de oportunidades nunca mostram uma vantagem contra um preço congelado e não apostável.

RelacionadoPermalink for this section

• Delta de Odds — referência de removed[], janela de retenção, padrão de polling
• Stream SSE — odds:removed, odds:locked, is_active no odds:update
• WebSocket — os mesmos eventos via WS
• Ao Vivo vs. Pré-Jogo — comportamento de suspensão das casas no jogo ao vivo