Skip to main content
/api/settlement?event_id=… gibt den Endstand, den Status und das Settlement pro Linie zurück.

Outcomes

Jede Zeile des settlement trägt outcome_home, outcome_draw, outcome_away:
Das Settlement deckt alle gehandelten Perioden ab — ganzes Spiel, Halbzeit, Viertel, Satz — sobald der Punktestand dieser Periode bekannt ist. Jede Zeile trägt ihre period. Eine Periode ohne bekannten Punktestand erzeugt keine Zeile statt eines geschätzten Urteils: die gemessene Abdeckung beträgt 87 % der Paare (Event, Periode), 97 % im Fußball, 73 % im Tennis, dessen Perioden Spiele sind. Solange das Spiel nicht abgerechnet ist, ist settlement leer und status spiegelt den aktuellen Zustand wider (started, pending); bei der Abrechnung wechselt er auf ended.

Viertellinien

Eine Linie in .25 oder .75 ist keine Linie, sondern zwei Wetten mit halbem Einsatz, platziert bei line ± 0.25. Bei einem Handicap -0.25 mit Unentschieden wird die auf 0 gesetzte Hälfte erstattet und die auf -0.5 gesetzte Hälfte verloren: das Urteil lautet half_loss, nicht loss. Die beiden Hälften können sich nie widersprechen — sie liegen 0,5 auseinander und die Marge einer Viertellinie ist nie null. Es existieren nur halber Gewinn und halber Verlust.

Ergebnisse pro Periode

/api/results?event_id=… ist eine eigene Route im iso-BIC-Format: sie liefert ein Array, ein Objekt je abgerechneter Periode. Bei Satz-Sportarten ist jeder Satz und jedes Spiel ein binäres Ergebnis (1‑0 / 0‑1); Periode 0 trägt die Satzanzahl.
Aktuelle Abdeckung: Satz-Sportarten (Tennis, Volleyball, Tischtennis…). Bei Sportarten mit fortlaufendem Score — Fußball, Basketball, Baseball — veröffentlicht Pinnacle im Echtzeit-Feed keine Abrechnung pro Periode, und /api/results gibt ein leeres Array zurück. Nutzen Sie dafür /api/settlement.

Abgerechnete Spiele entdecken

/api/settled?since=… durchläuft abgerechnete Spiele inkrementell: jede Antwort enthält einen last-Cursor, den Sie beim nächsten Aufruf zurückgeben. Das ist der einzige Weg, eine Abrechnung zu entdecken. Ein abgerechnetes Spiel hat das Book verlassen — sein Verschwinden löst die Abrechnung aus — es erscheint also nicht mehr in /api/fixtures, auch nicht mit live=2. Ohne diesen Durchlauf müsste man die event_id vor Spielende gespeichert haben.
Der since-Vergleich ist inklusiv: das letzte Ereignis einer Seite kann am Anfang der nächsten erneut auftauchen. Mehrere Spiele können dieselbe Abrechnungssekunde teilen, und eines zu verlieren wäre schlimmer, als es doppelt zu liefern — dedupliziere über event_id. Verfügbare Filter: sport_id, league_id, limit (1 bis 1000, Standard 200).

Backtesting

Die Kombination aus chronologischer Historie + Eröffnung/Schluss + true odds + Settlement ermöglicht das Backtesten von Strategien: die Quoten zu jedem Zeitpunkt rekonstruieren, den CLV messen und das Ergebnis überprüfen.