Ciclo de Vida del Mercado: Suspensiones y Eliminaciones

Los mercados salen del tablero constantemente — una casa suspende tras un gol, retira un umbral de hándicap o total cuando la línea se mueve, o liquida el evento. SharpAPI señala cada una de estas transiciones explícitamente en cada superficie de consumo. Nunca necesitas inferir que un mercado cerró esperando a que su precio parezca obsoleto.

Esta página es el mapa: qué señal se dispara cuándo, en qué superficie, y cómo mantener limpio tu estado local.

Las Dos Formas en que un Mercado Sale del TableroPermalink for this section

Las casas de apuestas retiran mercados del tablero de dos maneras distintas, y SharpAPI refleja ambas fielmente:

Matriz de Señales por SuperficiePermalink for this section

Si haces polling de /odds plano, la eliminación se comunica por ausencia: compara cada snapshot con el anterior y elimina las filas cuyos ids ya no aparecen. Funciona, pero te obliga a ti a calcular el diff — para avisos de eliminación explícitos, usa /odds/delta (su array removed[] nombra cada id retirado desde tu último poll) o el stream (push, sin polling alguno).

Escaleras de Umbrales: Hándicaps y TotalesPermalink for this section

Los mercados de hándicap (spread) y total son escaleras — un conjunto de peldaños en distintas líneas (-2.5, -3, -3.5, …; O/U 2.25, 2.5, 2.75, …). Cuando la línea principal se mueve, las casas — Pinnacle en particular — retiran los peldaños en los umbrales antiguos y publican nuevos. Cada peldaño es su propia fila de cuotas con su propio id, así que:

• Un peldaño retirado (el mercado de umbral que desaparece) dispara odds:removed / aparece en removed[], exactamente como cualquier otra eliminación.
• El peldaño nuevo llega como una fila fresca vía odds:update (o en el siguiente snapshot/delta), con los flags is_main_line / is_alternate_line indicándote dónde se sitúa en la escalera.
• Un peldaño que regresa (común en juego en vivo — las casas recentran las escaleras constantemente) vuelve a llegar bajo el mismo id determinista.

La rotación de la escalera es intensa durante el juego en vivo: los peldaños alternativos van y vienen muchas veces por partido. Trata una eliminación como “fuera del tablero ahora mismo”, no como un cierre terminal — solo la liquidación del evento es definitiva.

total 2.5 (id …_total_over_2.5)   ── la línea se mueve a 3 ──▶  odds:removed [..._total_over_2.5]
                                                                odds:update  [..._total_over_3]   (peldaño nuevo)

Patrón de cliente recomendadoPermalink for this section

Indexa tu estado local por id de cuota y aplica tres reglas, en orden de eventos:

1. odds:update (o una fila en data[]) → upsert de la fila.
2. odds:removed (o un id en removed[]) → borrar la fila.
3. is_active: false → conservar la fila pero marcarla como no apostable (atenuarla); una reapertura llega como un odds:update normal con is_active: true y un precio fresco.

# 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);
});

Precios Congelados y Protecciones contra Precios ObsoletosPermalink for this section

Dos flags a nivel de fila te protegen de actuar sobre un precio que la casa ya no honra:

Los propios motores de EV y arbitraje de SharpAPI excluyen las patas con is_active: false, de modo que los endpoints de oportunidades nunca muestran una ventaja contra un precio congelado y no apostable.

RelacionadoPermalink for this section

• Delta de Cuotas — referencia de removed[], ventana de retención, patrón de polling
• Stream SSE — odds:removed, odds:locked, is_active en odds:update
• WebSocket — los mismos eventos sobre WS
• En Vivo vs. Pre-Partido — comportamiento de suspensión de las casas en juego en vivo