Quotas & limites

Le quota dépend de votre plan. Une requête = 1 unité, quel que soit le nombre de lignes renvoyées. Le compteur est remis à zéro en haut de chaque heure (UTC).

Plan	Requêtes / heure
Essai (compte sans abonnement)	250
Starter	1 000
Pro	10 000
Sharp	20 000

Accès par plan

Certains endpoints sont réservés aux plans supérieurs :

Fonctionnalité	Starter	Pro	Sharp
Cotes prématch + live, fixtures, historique, opening/closing, résultats	✓	✓	✓
Specials (`/api/specials/*`)	—	—	✓
Flux temps réel (`/api/stream`, `/api/stream/event`, `/api/stream/odds`, `/api/stream/mqtt`)	—	—	✓

Un appel à un endpoint hors de votre plan renvoie 403 :

403

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

Headers de quota

Chaque réponse authentifiée porte :

Header	Description
`X-Quota-Limit`	Le plafond horaire de votre plan.
`X-Quota-Remaining`	Requêtes restantes pour l’heure UTC en cours.
`X-Quota-Cost`	Coût de cette requête (1).
`X-Rows`	Nombre de lignes renvoyées (informatif, si ≥ 1).
`Retry-After`	Uniquement sur les réponses `429` : secondes jusqu’à la prochaine heure UTC.

Dépassement (429)

Une fois le quota épuisé, les requêtes renvoient 429 jusqu’au reset :

429

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

Le header Retry-After indique le nombre de secondes avant le reset (haut de l’heure suivante, UTC).

Débit instantané : 50 requêtes / seconde

Indépendamment du quota horaire, chaque clé est plafonnée à 50 requêtes par seconde. Cette limite protège la disponibilité du service : sans elle, un seul client pourrait consommer son quota horaire en quelques secondes et saturer l’API pour tout le monde. Au-delà, la réponse est 429 — sans consommer de quota :

429

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

Le header Retry-After vaut 1 : le compteur repart à la seconde suivante, contrairement au quota horaire qui attend le haut de l’heure. En pratique, lissez vos appels plutôt que d’envoyer des rafales — 50 requêtes par seconde suffisent très largement à alimenter un modèle en temps réel.

Une seule connexion WebSocket par clé

Le flux WebSocket (/ws, plan Sharp) accepte une connexion simultanée par clé API. Chaque socket reçoit l’intégralité du flux : plusieurs connexions sur la même clé multiplient la bande passante sans rien apporter. Une seconde connexion est refusée avec le code de fermeture 4409 :

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

C’est la nouvelle connexion qui est refusée, jamais l’ancienne : un flux déjà établi ne sera pas coupé par un doublon — typiquement un script relancé sans avoir fermé le précédent. Si votre client s’est déconnecté brutalement, la place se libère à la fermeture du socket côté serveur, et une reconnexion immédiate fonctionne. Besoin de plusieurs flux en parallèle ? Créez une clé par processus depuis votre espace client.

Suivre votre consommation

Votre consommation de l’heure en cours est aussi affichée dans votre espace client.

Démarrer

Concepts

Quotas & limites

Accès par plan

Headers de quota

Dépassement (429)

Débit instantané : 50 requêtes / seconde

Une seule connexion WebSocket par clé

Suivre votre consommation

​Accès par plan

​Headers de quota

​Dépassement (429)

​Débit instantané : 50 requêtes / seconde

​Une seule connexion WebSocket par clé

​Suivre votre consommation

Accès par plan

Headers de quota

Dépassement (429)

Débit instantané : 50 requêtes / seconde

Une seule connexion WebSocket par clé

Suivre votre consommation