Markt-Lebenszyklus: Aussetzungen und Entfernungen

Märkte verschwinden ständig vom Board — ein Buchmacher setzt nach einem Tor aus, zieht eine Handicap- oder Total-Linie zurück, wenn sich die Hauptlinie bewegt, oder rechnet das Event ab. SharpAPI signalisiert jeden dieser Übergänge explizit auf jeder Konsumoberfläche. Sie müssen nie daraus schließen, dass ein Markt geschlossen wurde, indem Sie warten, bis sein Preis veraltet aussieht.

Diese Seite ist die Übersicht: welches Signal wann ausgelöst wird, auf welcher Oberfläche, und wie Sie Ihren lokalen Zustand sauber halten.

Die zwei Arten, wie ein Markt das Board verlässtPermalink for this section

Sportwettenanbieter nehmen Märkte auf zwei unterschiedliche Arten vom Board, und SharpAPI spiegelt beide originalgetreu wider:

Signal-Matrix nach OberflächePermalink for this section

Wenn Sie nur /odds pollen, wird die Entfernung durch Abwesenheit kommuniziert: Vergleichen Sie jeden Snapshot mit dem vorherigen und entfernen Sie Zeilen, deren ids nicht mehr erscheinen. Das funktioniert, aber Sie müssen den Diff selbst berechnen — für explizite Entfernungsmeldungen nutzen Sie /odds/delta (dessen removed[]-Array jede seit Ihrem letzten Poll entfernte id benennt) oder den Stream (Push, gar kein Polling).

Threshold-Leitern: Handicaps und TotalsPermalink for this section

Handicap- (Spread-) und Total-Märkte sind Leitern — eine Menge von Sprossen auf verschiedenen Linien (-2.5, -3, -3.5, …; O/U 2.25, 2.5, 2.75, …). Wenn sich die Hauptlinie bewegt, ziehen Buchmacher — insbesondere Pinnacle — Sprossen an den alten Schwellenwerten zurück und veröffentlichen neue. Jede Sprosse ist eine eigene Quotenzeile mit eigener id, daher:

• Eine zurückgezogene Sprosse (der verschwindende Threshold-Markt) löst odds:removed aus / erscheint in removed[], genau wie jede andere Entfernung.
• Die neue Sprosse trifft als frische Zeile via odds:update ein (oder im nächsten Snapshot/Delta), mit den Flags is_main_line / is_alternate_line, die Ihnen sagen, wo sie in der Leiter sitzt.
• Eine zurückkehrende Sprosse (häufig im Live-Spiel — Buchmacher zentrieren Leitern ständig neu) trifft unter der gleichen deterministischen id wieder ein.

Die Leiterrotation ist während des Live-Spiels intensiv: alternative Sprossen kommen und gehen viele Male pro Spiel. Behandeln Sie eine Entfernung als “gerade jetzt nicht auf dem Board”, nicht als endgültige Schließung — nur die Event-Abrechnung ist final.

total 2.5 (id …_total_over_2.5)   ── Linie bewegt sich auf 3 ──▶  odds:removed [..._total_over_2.5]
                                                                  odds:update  [..._total_over_3]   (neue Sprosse)

Empfohlenes Client-MusterPermalink for this section

Indizieren Sie Ihren lokalen Zustand nach Quoten-id und wenden Sie drei Regeln in Event-Reihenfolge an:

1. odds:update (oder eine Zeile in data[]) → Zeile upserten.
2. odds:removed (oder eine id in removed[]) → Zeile löschen.
3. is_active: false → Zeile behalten, aber als nicht wettbar markieren (ausgrauen); eine Wiedereröffnung trifft als normales odds:update mit is_active: true und einem frischen Preis ein.

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

Eingefrorene Preise und Schutz vor veralteten PreisenPermalink for this section

Zwei Flags auf Zeilenebene schützen Sie davor, auf einen Preis zu reagieren, den der Buchmacher nicht mehr anbietet:

SharpAPIs eigene EV- und Arbitrage-Engines schließen is_active: false-Legs aus, sodass die Opportunity-Endpunkte nie eine Edge gegen einen eingefrorenen, nicht wettbaren Preis ausweisen.

Verwandte ThemenPermalink for this section

• Quoten-Delta — removed[]-Referenz, Aufbewahrungsfenster, Polling-Muster
• SSE-Stream — odds:removed, odds:locked, is_active auf odds:update
• WebSocket — dieselben Events über WS
• Live vs. Pre-Match — Aussetzungsverhalten der Buchmacher im Live-Spiel