Wie eine Odds-Feed-API funktioniert: Snapshot bis Abrechnung

Ein Sportsbook-Bildschirm wirkt statisch: eine Liste von Spielen, eine Spalte mit Quoten. Darunter ist ein Quoten-Feed ein Strom aus Tausenden kleiner Änderungen, und die Aufgabe des Betreibers ist es, jede davon in der richtigen Reihenfolge anzuwenden. Dieser Ratgeber folgt dem Strom von der ersten Anfrage bis zur abgerechneten Wette.

1. Das Datenmodell

Fast jeder Feed nutzt dieselbe Hierarchie:

• Sportart: Fußball, Tennis, Esports.
• Turnier oder Liga: Premier League, ATP Tokio, League of Legends Worlds.
• Event: ein Spiel mit Anstoßzeit und Teilnehmern.
• Markt: eine Frage zum Event, etwa 1X2, Über/Unter 2,5 Tore oder Map-Handicap.
• Ausgang: eine Antwort, mit einer Quote und einem Status (aktiv, gesperrt, abgerechnet).

Jedes Element hat eine stabile Kennung. Die meisten Integrationsfehler entstehen, wenn Namen als Kennungen behandelt werden: Teamnamen ändern ihre Schreibweise, IDs nicht.

2. Erst Snapshot, dann Deltas

Beim Start fordert der Client einen Snapshot an: den vollständigen aktuellen Stand. Danach erhält er Deltas, kleine Nachrichten wie „diese Quote hat sich bewegt“, „dieser Markt ist gesperrt“, „dieses Event hat begonnen“.

Gute Feeds nummerieren ihre Deltas. Nocturn Sport zum Beispiel beschreibt seinen Feed als vollständigen Snapshot plus versionierte Deltas. Hält der Client Version N und erhält N+2, weiß er, dass eine Nachricht verloren ging, und lädt neu, statt eine veraltete Quote anzuzeigen. Feeds ohne Versionen zwingen den Client zum Raten, und durch Raten bieten Buchmacher am Ende die Quoten von gestern an.

3. Push und Pull

Bei Live-Fußball kann sich eine Quote mehrmals pro Minute ändern, daher pushen Live-Feeds Nachrichten meist über eine dauerhafte Verbindung. Pre-Match-Quoten bewegen sich langsam genug, dass ein Pull über HTTP alle paar Sekunden oft genügt. Viele Betreiber nutzen beides: Pull für den Pre-Match-Katalog, Push für In-Play.

4. Sperren

Eine Sperre ist der Feed, der sagt: „Jetzt keine Wetten darauf annehmen.“ Auslöser sind ein Tor, ein Elfmeter, ein Break, das Ende einer Map oder der Verlust der eigenen Datenquelle beim Lieferanten. Der Client muss Sperren schneller anwenden als alles andere; eine Quote, die in den Sekunden nach einem Tor angenommen wird, ist der klassische Weg, Geld zu verlieren.

Pre-Match-Märkte schließen außerdem vor dem Anpfiff. Nocturn Sport zum Beispiel schließt sie eine Minute vor Beginn.

5. Die Wette platzieren

Geht die API über das Veröffentlichen von Quoten hinaus, folgt die Wettabgabe einem Muster:

1. Der Client schickt die Auswahl, die angezeigte Quote und den Einsatz, mit einer eindeutigen Request-ID.
2. Der Server prüft, ob die Quote noch gilt und der Markt offen ist.
3. Er nimmt an, lehnt ab oder bietet eine neue Quote.
4. Fällt das Netzwerk aus, sendet der Client erneut mit derselben Request-ID, und der Server liefert die ursprüngliche Antwort, statt eine zweite Wette anzulegen.

Dieser letzte Schritt, die Idempotenz, schützt sowohl den Saldo des Spielers als auch die Bücher des Betreibers.

6. Abrechnung

Endet das Event, veröffentlicht der Feed Ergebnisse pro Ausgang: gewonnen, verloren, ungültig oder halb gewonnen und halb verloren bei geteilten Linien wie asiatischen Handicaps. Die Plattform rechnet jede Wette danach ab. Korrekturen kommen vor: Ein Ergebnis kann nach Prüfung geändert werden, also muss ein Abrechnungsprozess sauber neu abrechnen können.

7. Was vor dem Livegang zu testen ist

• Die Verbindung mitten im Spiel kappen und die Wiederherstellung prüfen.
• Ein Delta in falscher Reihenfolge einspielen und prüfen, ob der Client es bemerkt.
• Dieselbe Wette zweimal mit einer Request-ID platzieren.
• Eine Kombiwette abrechnen, bei der ein Tipp ungültig ist.

Ein Feed, der diese vier Tests übersteht, ist bereit für einen Samstagnachmittag.