Skip to main content
Jede Quotenlinie wird durch (period, market, line) identifiziert und trägt eine stabile ganzzahlige line_id.

Markttypen

Bei 2‑way-Märkten (spread/totals) ist odds0 gleich null.

units — die Einheit der Linie (Tennis: Games vs. Sätze)

Manche Sportarten quotieren denselben Markt in zwei verschiedenen Einheiten. Im Tennis kann ein spread ein Satz-Handicap (Linie ±1.5) oder ein Game-Handicap (Linie -4.5, +5.5…) sein, und ein totals kann sich auf Sätze (2.5) oder Games (21.5) beziehen. Das Feld units beseitigt die Mehrdeutigkeit: Die Spieler-Totals (home_totals / away_totals) im Tennis sind immer in Games (units = "Games"). Das Feld ist auf /api/odds, /api/opening, /api/closing, /api/history und den Echtzeit-Streams vorhanden.

Perioden

period = 0 = ganzes Spiel. Die übrigen Perioden hängen von der Sportart ab (1 = erste Halbzeit / Satz usw.). Rufen Sie den Katalog über /api/periods ab.

Hauptlinien vs. alt‑lines

Standardmäßig gibt /api/odds alle Linien zurück (einschließlich der Alternativen). Fügen Sie main_lines_only=1 hinzu, um nur die Hauptlinie jedes Marktes zu behalten (alt_line_id null).

max_win

max_win = maximal akzeptierter Einsatz (Pinnacle-Limit) auf der Linie, ein Liquiditätsindikator.

Historie: max_win und status sind Serienpunkte

/api/history liefert einen Punkt pro tatsächlicher Änderung, nie einen wiederholten Wert. Ein Punkt entsteht, sobald sich eines dieser Felder ändert: Ein steigendes max_win bei unveränderter Quote ist ein Vertrauenssignal des Buchmachers; ein einbrechendes max_win geht einer Aussetzung oft voraus. Die Serie ist serverseitig bereits dedupliziert und kann direkt geplottet werden.

Eine einzelne Wette isolieren

Ohne Filter liefert /api/history die Zeitreihe aller Linien des Spiels. Bei einem Basketballspiel mit seinen Alt-Lines sind das regelmäßig über 24.000 Punkte, verteilt auf mehr als 400 Wetten — obwohl Sie nur eine Kurve wollten. Zwei Wege, die Wette zu benennen, je nachdem was Ihnen vorliegt:
Für einen Markt ohne Linie (Moneyline) übergeben Sie line=null oder line=. Den Parameter wegzulassen bedeutet „kein Filter auf die Linie” — Sie bekämen auch sämtliche Handicaps.
Die Filter gelten ebenso für opening und closing: Sie erhalten Eröffnung und Schluss der angefragten Wette, nicht die der übrigen 414. An einem echten Spiel gemessen:

Die drei Status-Ebenen

Pinnacle veröffentlicht einen Status auf drei verschiedenen Ebenen, jede mit eigenem Vokabular. Sie zu verwechseln ist der häufigste Fehler: ein geschlossener Markt bedeutet kein beendetes Spiel, und eine abgerechnete Halbzeit schließt nicht die Wetten auf das ganze Spiel.

Ebene Linie

Der Status gehört zur Linie, nicht zum Markt. Innerhalb desselben (event_id, period, market) laufen die Stufen auseinander — Pinnacle schließt ein bestimmtes Total und lässt die Nachbarn offen:
Zwei Felder beschreiben ihn: status, eine Ganzzahl in BIC-Parität (1 = offen, 2 = alles andere), und status_raw, das Wort genau so, wie Pinnacle es sendet.
status_raw ist nur bei aktuellen Quoten gefüllt. Die Historie (/api/history, full_history=1) speichert nur die Ganzzahl: das ursprüngliche Wort wird nicht abgelegt, das Feld ist dort null.

Ebene Periode

/api/fixtures liefert periods, eine Liste {period, status, cutoff}. Hier erklärt Pinnacle, dass eine Halbzeit geschlossen ist — unabhängig von den Linien und vom Spielstatus:
Die Abrechnung einer Periode ist im Stream ein eigenständiges Ereignis: eine Halbzeit, die auf settled wechselt, löst ein event: update-Frame aus, ohne dass sich eine Quote bewegen muss.
Hier ist die erste Halbzeit abgerechnet, während das gesamte Spiel weiter bewettbar bleibt.

Aussetzung von endgültiger Schließung unterscheiden

Kein Feld sagt es — die Zeit tut es:
  • Aussetzung — die Linie bleibt veröffentlicht, wechselt auf closed, behält ihre letzte bekannte Quote (wir löschen sie nicht, so wie die Pinnacle-Oberfläche den Preis ausgraut) und kehrt dann zu open zurück;
  • endgültige Schließung — die Linie wird nicht mehr veröffentlicht: ihr cutoff läuft ab, sie verlässt /api/odds, und eine Entfernung wird im Stream angekündigt (siehe Prematch & live).
Über 327.832 fortlaufend im Feed beobachtete Status nimmt status_raw nur die Werte "open" und "closed" an — auch eine Tennis-Aussetzung zwischen zwei Punkten kommt als "closed" an. Verlassen Sie sich also nicht auf ein eigenes Wort zur Unterscheidung; die Messung betrifft ein Beobachtungsfenster, keine vertragliche Zusage von Pinnacle.