Quelles sont les limites de taux d'API pour le marché à terme Coinbase?

L'API à terme Coinbase applique les limites de taux: 3 req / sec par IP pour les points de terminaison publics, 10 req / sec par clé d'API pour privé; Utilisez les websockets et la mise en cache pour optimiser.

Aug 11, 2025 at 08:29 pm

Comprendre les limites de taux d'API sur les contrats à terme sur Coinbase

Lors de l'interaction avec le marché à terme Coinbase via son API, les développeurs doivent adhérer à des limites de taux spécifiques conçues pour maintenir la stabilité du système et l'utilisation équitable. Ces limites contrôlent le nombre de demandes qu'un utilisateur peut faire dans une fenêtre de temps donnée. Le dépassement de ces seuils peut entraîner des réponses temporaires HTTP 429 trop de demandes , ce qui a mis un accès supplémentaire jusqu'à ce que la fenêtre de limite de taux réinitialise. Les limites exactes dépendent du type de point de terminaison, de la méthode d'authentification et si la demande est publique ou privée.

Pour l' API commerciale Advanced Coinbase , qui prend en charge le trading à terme, les limites de taux sont appliquées par point par rapport. Les points de terminaison publics, tels que ceux qui vont chercher des données de marché tels que les livres de commandes ou les prix des ticker, permettent généralement des volumes de demande plus élevés par rapport aux points de terminaison privés qui impliquent des actions de compte telles que la mise en place de commandes ou les soldes de chèque. Ces points de terminaison publics sont généralement limités à 3 demandes par seconde par adresse IP lorsqu'ils sont non authentifiés. Cela signifie que sans une clé API, votre accès est limité à ce seuil sur tous les points de terminaison des données à terme public.

Limites de taux d'évaluation authentifiées

Lorsque vous utilisez une clé API et un secret pour authentifier les demandes, les limites de taux sont liées au compte d'utilisateur plutôt qu'à l'adresse IP. Cela permet un débit plus cohérent et plus élevé, en particulier pour les commerçants qui s'appuient sur des systèmes automatisés. Pour les demandes authentifiées sur les points de terminaison privés, tels que la soumission des commandes à terme , l'annulation des commandes ou la récupération des informations de position - la limite de taux est d'environ 10 demandes par seconde par touche API. Cette limite est essentielle pour les commerçants algorithmiques qui doivent gérer soigneusement la fréquence des demandes pour éviter la limitation.

Il est essentiel de noter que dépasser la limite de taux entraîne un bloc temporaire, dure généralement quelques minutes. Pour éviter cela, les développeurs doivent mettre en œuvre des stratégies de revers exponentielles et surveiller les en-têtes de réponse HTTP renvoyés par l'API. Les en-têtes clés comprennent:

• cb-after-rate-limit-reset : Indique le nombre de secondes jusqu'à ce que la limite de taux se réinitialise.
• cb-after-rate-limit-remaining : montre combien de demandes restent dans la fenêtre actuelle.
• cb-after-rate-limit-cap : Spécifie le nombre total de demandes autorisées par fenêtre.

La surveillance de ces en-têtes permet un ajustement en temps réel de la stimulation de la demande, en garantissant le respect des politiques de contrôle des taux de Coinbase .

Différenciation entre les critères de terminaison publics et privés

L' API Coinbase Futures distingue l'accès aux données publiques et privées, chacune avec des limites de taux distinctes. Les points de terminaison publics comprennent:

• GET / API / V3 / COURACE / MARCHE / PRODUITS - Récupère les contrats à terme disponibles.
• Get / api / v3 / courtier / marché / product_book - récupére les données du carnet de commandes.
• GET / API / V3 / COURACE / MARCHE / BOUCTIONS - Renvoie des bougies de prix historiques.

Ces points de terminaison sont limités à taux à 3 demandes par seconde par IP si non authentifiés. Lorsqu'ils sont authentifiés, ils peuvent bénéficier d'une manipulation légèrement plus indulgente, mais le principal avantage de l'authentification réside dans l'accès aux points de terminaison privés.

Les points de terminaison privés, qui nécessitent des informations d'identification API valides , incluent:

• POST / API / V3 / COURRACE / ORDERS - Passe une nouvelle commande à terme.
• Delete / api / v3 / courtier / ordres / {Order_id} - annule un ordre existant.
• Get / api / v3 / courtier / positions - récupère les positions ouvertes actuelles.
• GET / API / V3 / BROKERAGE / COMPTES - Répertorie les comptes de trading.

Ceux-ci sont limités à 10 demandes par seconde par clé d'API , et les rafales soutenues peuvent déclencher une suspension temporaire. Les développeurs doivent concevoir leurs applications à la file d'attente et des demandes de gaz pour rester dans ces limites.

Gestion des limites de taux dans la pratique

Pour fonctionner efficacement dans le cadre de limite de taux de Coinbase , les développeurs doivent mettre en œuvre une gestion robuste des demandes. Une méthode efficace consiste à utiliser un algorithme de godet de jeton , où chaque demande d'API consomme un jeton, et les jetons sont reconstitués à un taux fixe. Cela garantit que les demandes sont espacées de manière appropriée.

Une autre étape pratique consiste à mettre en cache les données publiques localement lorsque cela est possible. Par exemple, au lieu d'appeler à plusieurs reprises le point de terminaison de la liste des produits, stockez les spécifications du contrat et actualisez-les toutes les quelques minutes. Cela réduit les appels d'API inutiles et aide à préserver le budget de limite de taux pour les opérations critiques comme l'exécution de l'ordre.

Lorsque vous construisez des systèmes de trading automatisés, considérez:

• Les requêtes liées par lots en demandes uniques où sont prises en charge.
• Utilisation de flux WebSocket pour des données de marché en temps réel au lieu de sonder les points de terminaison de repos.
• Implémentation de la logique de réessayer avec des retards basés sur l'en-tête cb-after-rate-limit-reset .

Les connexions WebSocket, telles que le flux WebSocket de Coinbase Advanced Trade , offrent un moyen plus efficace de recevoir des mises à jour en direct sur les livres de commandes, les transactions et les changements de compte sans consommer des limites de taux d'API REST. L'abonnement à des canaux comme level2 , matches ou user permet un flux de données continu avec un minimum de frais généraux.

Meilleures pratiques pour la configuration des clés de l'API

Pour maximiser la fiabilité et la sécurité, configurez votre clé API avec les autorisations minimales requises. Pour les échanges à terme, restreignez la clé pour échanger et voir les portées uniquement - éviter les autorisations de retrait ou de transfert. Cela réduit le risque en cas de compromis.

Stockez votre secret API et votre phrase secrète en toute sécurité à l'aide de variables d'environnement ou d'un gestionnaire de secrets. Jamais les informations d'identification HardCode dans les fichiers source. Lorsque vous faites des demandes, assurez-vous que tous les en-têtes sont correctement formatés:

• CB-ACCESS-KEY : Votre clé API.
• CB-ACCESS-SIGN : HMAC-SHA256 Signature du message.
• CB-ACCESS-TIMESTAMP : horodatage Unix de la demande.
• CB-ACCESS-PASSPHRASE : La phrase secrète utilisée lors de la création de la clé.

Chaque corps de demande doit être sérialisé et signé correctement. Par exemple, lors de la mise en place d'un ordre à terme, la chaîne de messages doit inclure l'horodatage, la méthode HTTP, le chemin de demande et le corps (si présent), tous concaténés et hachés avec l'API Secret.

Questions fréquemment posées

Puis-je augmenter ma limite de taux d'API sur les contrats à terme sur Coinbase?

Non, les limites de taux sont fixes par clé d'API et ne peuvent pas être augmentées par le biais de mises à niveau de compte ou de demandes de support. Les traders à volume élevé devraient optimiser leurs modèles de demande plutôt que de rechercher des limites plus élevées.

Les connexions WebSocket comptent-elles vers les limites de taux de l'API REST?

Non, les abonnements WebSocket ne consomment pas de limites de taux de repos . Ils opèrent sur un canal séparé et sont la méthode préférée pour recevoir des données de marché en temps réel sans avoir un impact sur votre quota de demande.

Que se passe-t-il si je dépasse la limite de taux?

Vous recevrez une réponse HTTP 429 , et d'autres demandes seront bloquées pour une courte durée, soit généralement moins de 60 secondes. Implémentez la logique de réessayer avec un backoff exponentiel pour gérer cela gracieusement.

Les limites de taux sont-elles partagées sur plusieurs clés API à partir du même compte?

Non, chaque clé API a sa propre limite de taux indépendante . La création de plusieurs clés permet un accès parallélisé, mais chacun est toujours plafonné à 10 demandes par seconde pour les points de terminaison privés.