Rate Limits

Das Kontingent hängt von Ihrem Plan ab. Eine Anfrage = 1 Einheit, unabhängig von der Anzahl zurückgegebener Zeilen. Der Zähler wird zu Beginn jeder Stunde (UTC) zurückgesetzt.

Plan	Anfragen / Stunde
Test (Konto ohne Abo)	250
Starter	1.000
Pro	10.000
Sharp	20.000

Zugriff nach Plan

Einige Endpoints sind höheren Plänen vorbehalten:

Funktion	Starter	Pro	Sharp
Prematch- + Live-Quoten, Fixtures, Historie, Opening/Closing, Ergebnisse	✓	✓	✓
Specials (`/api/specials/*`)	—	—	✓
Echtzeit-Streams (`/api/stream`, `/api/stream/event`, `/api/stream/odds`, `/api/stream/mqtt`)	—	—	✓

Der Aufruf eines Endpoints außerhalb Ihres Plans liefert 403:

403

{
  "detail": "Endpoint réservé au plan Sharp (enterprise)",
  "your_plan": "starter",
  "required_plan": "enterprise"
}

Quota-Header

Jede authentifizierte Antwort enthält:

Header	Beschreibung
`X-Quota-Limit`	Das Stundenlimit Ihres Plans.
`X-Quota-Remaining`	Verbleibende Anfragen für die laufende UTC-Stunde.
`X-Quota-Cost`	Kosten dieser Anfrage (1).
`X-Rows`	Anzahl zurückgegebener Zeilen (informativ, wenn ≥ 1).
`Retry-After`	Nur bei `429`-Antworten: Sekunden bis zur nächsten UTC-Stunde.

Überschreitung (429)

Ist das Kontingent erschöpft, liefern Anfragen 429 bis zum Reset:

429

{
  "detail": "Quota de requêtes horaire dépassé",
  "quota": { "limit": 10000, "used": 10000, "period": "2026-07-22T14" }
}

Der Retry-After-Header gibt die Sekunden bis zum Reset an (Beginn der nächsten Stunde, UTC).

Momentandurchsatz: 50 Anfragen / Sekunde

Zusätzlich zum Stundenkontingent ist jeder Schlüssel auf 50 Anfragen pro Sekunde begrenzt. Diese Grenze schützt die Verfügbarkeit des Dienstes: ohne sie könnte ein einzelner Client sein Stundenkontingent in Sekunden aufbrauchen und die API für alle lahmlegen. Darüber hinaus lautet die Antwort 429 — ohne Kontingent zu verbrauchen:

429

{
  "detail": "Débit maximal dépassé : 50 requêtes par seconde et par clé. Réessayez dans une seconde.",
  "limit_per_second": 50
}

Der Header Retry-After ist 1: der Zähler startet in der nächsten Sekunde neu, anders als beim Stundenkontingent, das auf den Stundenbeginn wartet. Verteilen Sie Ihre Aufrufe in der Praxis, statt Stöße zu senden — 50 Anfragen pro Sekunde reichen für ein Echtzeitmodell bei Weitem aus.

Nur eine WebSocket-Verbindung pro Schlüssel

Der WebSocket-Feed (/ws, Sharp-Plan) akzeptiert eine gleichzeitige Verbindung pro API-Schlüssel. Jeder Socket erhält den vollständigen Feed: mehrere Verbindungen mit demselben Schlüssel vervielfachen nur die Bandbreite, ohne etwas zu bringen. Eine zweite Verbindung wird mit dem Schließcode 4409 abgelehnt:

4409 Une seule connexion WebSocket par clé API. Fermez la connexion existante avant d'en ouvrir une autre.

Abgelehnt wird die neue Verbindung, nie die bestehende: ein bereits laufender Feed wird nicht zugunsten eines Duplikats gekappt — typischerweise ein Skript, das ohne Schließen des vorherigen neu gestartet wurde. Bei einem abrupten Verbindungsabbruch wird der Platz beim serverseitigen Schließen des Sockets frei, und ein sofortiger Reconnect funktioniert. Mehrere parallele Feeds nötig? Legen Sie in Ihrem Kundenbereich einen Schlüssel pro Prozess an.

Verbrauch verfolgen

Ihr Verbrauch der laufenden Stunde wird auch in Ihrem Kundenbereich angezeigt.

Erste Schritte

Konzepte

Zugriff nach Plan

Quota-Header

Überschreitung (429)

Momentandurchsatz: 50 Anfragen / Sekunde

Nur eine WebSocket-Verbindung pro Schlüssel

Verbrauch verfolgen

​Zugriff nach Plan

​Quota-Header

​Überschreitung (429)

​Momentandurchsatz: 50 Anfragen / Sekunde

​Nur eine WebSocket-Verbindung pro Schlüssel

​Verbrauch verfolgen

Zugriff nach Plan

Quota-Header

Überschreitung (429)

Momentandurchsatz: 50 Anfragen / Sekunde

Nur eine WebSocket-Verbindung pro Schlüssel

Verbrauch verfolgen