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 QuadroLink permanente para esta seção

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

Matriz de Sinais por SuperfícieLink permanente para esta seção

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 TotaisLink permanente para esta seção

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 recomendadoLink permanente para esta seção

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:
    offset = 0
    while True:
        r = get(f"/api/v1/odds/delta?since={since}&sportsbook=pinnacle"
                f"&limit=500&offset={offset}").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
        if not r["pagination"]["has_more"]:
            if r.get("overflow"):             # scan stopped short: since would gap
                raise RuntimeError("re-baseline from /odds, then resume with the "
                                   "first baseline page's updated_at as since")
            since = r["meta"]["server_time"]  # terminal page: real watermark
            break
        if r["pagination"]["next_offset"] is None:
            raise RuntimeError("re-baseline from /odds, then resume with the "
                               "first baseline page's updated_at as since")
        offset = r["pagination"]["next_offset"]
    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 ObsoletosLink permanente para esta seção

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.

RelacionadoLink permanente para esta seção

• 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