Limites de débit et plans

Deux types de limites

Chaque plan dispose d'un quota mensuel, le nombre de requêtes facturables par mois civil, et d'une limite par minute qui protège l'API contre les pics de trafic. Les quotas sont réinitialisés à 00:00 UTC le 1er de chaque mois.

Les plans diffèrent aussi par leur intervalle de mise à jour, c'est-à-dire la fraîcheur des prix. Interroger l'API plus souvent que cet intervalle renvoie les mêmes prix et ne fait que consommer du quota.

Les plans en un coup d'œil

• Free : 100 requêtes/mois, mises à jour quotidiennes, 10 requêtes/minute
• Lite : 1 000 requêtes/mois, mises à jour toutes les 30 minutes, 30 requêtes/minute
• Standard : 10 000 requêtes/mois, mises à jour toutes les 10 minutes, 60 requêtes/minute
• Advanced : 50 000 requêtes/mois, mises à jour toutes les 60 secondes, 120 requêtes/minute
• Pro : 100 000 requêtes/mois, mises à jour toutes les 60 secondes, 300 requêtes/minute
• Ultra : 500 000 requêtes/mois, mises à jour toutes les 15 secondes, 600 requêtes/minute
• Business : 500 000 requêtes/mois, mises à jour toutes les 15 secondes, 600 requêtes/minute, plus un SLA de disponibilité
• Enterprise : 1 500 000 requêtes/mois, mises à jour toutes les 5 secondes, 1 200 requêtes/minute

Les fonctionnalités s'étoffent elles aussi avec le plan. Les prix par carat nécessitent un plan payant, les prix bid/ask sont disponibles dès Standard, les alertes par webhook dès Advanced et le flux en temps réel dès Pro. Consultez les tarifs pour connaître les prix actuels.

Ce qui compte comme une requête

• Chaque appel réussi à un endpoint de données compte pour une requête, quel que soit le nombre de symboles renvoyés.
• /symbols et /usage sont gratuits et ne sont jamais décomptés.
• Les requêtes rejetées avec 104 (limite par minute), 106 (non inclus dans votre plan), 107 (origine non autorisée) ou une erreur serveur (500, 503) ne sont pas facturées.
• Les requêtes qui échouent à cause de leurs propres paramètres sont décomptées. Cela concerne les erreurs de validation 201 à 210 et 300 (aucun résultat) : validez donc les dates et les symboles avant de les envoyer.

Suivre votre consommation

Chaque réponse authentifiée indique votre quota dans des en-têtes :

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9876
X-RateLimit-Used: 124
X-RateLimit-Reset: 1793491200
X-RateLimit-Reset-Date: 2026-11-01T00:00:00.000Z
X-RateLimit-Plan: Standard
X-RateLimit-Minute-Limit: 60
X-RateLimit-Minute-Remaining: 59

Les mêmes valeurs figurent dans l'objet rate_limit du corps JSON. reset est un horodatage Unix et reset_date le même instant au format ISO 8601 : le début du mois suivant, en UTC.

Vérifier votre consommation sans entamer votre quota

Appelez /usage depuis vos tableaux de bord ou vos outils de supervision. C'est gratuit :

{
  "success": true,
  "usage": {
    "requests_made": 124,
    "requests_quota": 10000,
    "requests_remaining": 9876,
    "plan": "standard",
    "period_start": "2026-10-01T00:00:00.000Z",
    "period_end": "2026-11-01T00:00:00.000Z"
  },
  "result": { "plan": "Standard", "used": 124, "total": 10000, "remaining": 9876 },
  "rate_limit": {
    "limit": 10000,
    "remaining": 9876,
    "reset": 1793491200,
    "used": 124,
    "plan": "Standard",
    "reset_date": "2026-11-01T00:00:00.000Z"
  }
}

Lorsque vous atteignez une limite

Les deux limites répondent avec le statut HTTP 429 et un corps d'erreur :

• 104 too_many_requests : trop de requêtes au cours de la minute en cours. La réponse inclut un en-tête Retry-After indiquant le nombre de secondes à attendre. Ralentissez, puis réessayez.
• 105 quota_exceeded : le quota mensuel est épuisé. Les requêtes continuent d'échouer jusqu'à la réinitialisation du quota le 1er du mois (UTC). Un passage à un plan supérieur prend effet immédiatement.

{
  "success": false,
  "error": {
    "code": 105,
    "type": "quota_exceeded",
    "info": "User has reached or exceeded his subscription plan's monthly API request allowance"
  }
}

Rester dans les limites de votre quota

• Mettez les réponses en cache pendant au moins l'intervalle de mise à jour de votre plan.
• Demandez tous les symboles nécessaires en un seul appel plutôt qu'un appel par symbole.
• Interroger l'API toutes les 10 minutes représente environ 4 500 requêtes par mois ; toutes les minutes, environ 45 000. Choisissez le plan adapté à votre fréquence d'interrogation.
• À partir du plan Pro, utilisez le flux en temps réel plutôt que le polling, et les alertes de prix pour réagir au franchissement de seuils.

D'autres conseils sont disponibles dans Bonnes pratiques.