Live-Quoten API

Live-Quoten API per WebSocket

REST liefert den aktuellen Stand, der WebSocket jede Änderung danach: neue Quote, Sperrung, Schließung. So bleiben Vergleichsseiten und Trading-Oberflächen aktuell, ohne im Sekundentakt zu pollen.

Live ist im Growth- und Pro-Plan enthalten und gilt für Buchmacher, die für Live verifiziert sind. Pläne vergleichen

  1. 01

    Kanal abonnieren

    Mit dem API-Schlüssel verbinden und odds.{sportart}.{buchmacher} abonnieren.

  2. 02

    Updates anwenden

    Jede odds.update-Nachricht ersetzt die Quote einer Auswahl; suspended blendet sie aus.

  3. 03

    Nach Reconnect synchronisieren

    Nach einem Verbindungsabbruch den aktuellen Stand per REST neu laden, dann weitere Updates anwenden.

Protokoll

Nachrichten auf dem Live-Kanal

subscribe

Einen Kanal pro Sportart und Buchmacher öffnen, z. B. odds.football.tipico.

odds.update

Eine Nachricht pro Quotenänderung mit sequence, Markt, Auswahl, Dezimalquote und Status.

status: suspended

Quote ist beim Buchmacher gesperrt; closed beendet sie.

subscription.rejected

Ablehnung mit Code, z. B. wenn Plan oder Schlüssel keinen Live-Zugang haben.

WebSocket-Sitzung
// Tipico is shown for illustration only; it is not part of current customer coverage.
// wss://stream.betspread.io
// Authorization: Bearer <API_KEY> on the upgrade request
{ "type": "subscribe", "channel": "odds.football.tipico" }

// one message per quote change
{
  "type": "odds.update",
  "sequence": "1779670123999",
  "channel": "odds.football.tipico",
  "market": { "type": "match_result_1x2", "line": null },
  "outcome": "away",
  "odds": 2.1,
  "status": "suspended"
}

Kanäle, Ablehnungen, Close-Codes und Abrechnung beschreibt die Live-Doku (englisch). Einen Überblick über REST und Live gibt die Quoten API.

Sichere dir deinen Platz zum Start.