Quelles sont les limites de taux de l'API pour le commerce automatisé sur les contrats de recours?

Bybit applique les limites de taux d'API - 1220 demandes / 5 sec par IP pour les points de terminaison publics, 60/5 sec par clé d'API pour privé - pour assurer la stabilité et l'utilisation équitable.

Aug 08, 2025 at 06:08 am

Comprendre les limites de taux d'API sur le recours

Lorsque vous vous engagez dans des échanges automatisés sur des contrats de recours , la compréhension des limites de taux d'API est essentielle pour éviter les perturbations de l'exécution de la stratégie. Bybit applique des limites de taux pour maintenir la stabilité de la plate-forme et assurer une utilisation équitable entre tous les utilisateurs. Ces limites sont mesurées en demandes par seconde (RPS) et varient en fonction du type de point de terminaison accessible - que ce soit public ou privé - et l'état d'authentification de la demande. Le dépassement de ces seuils peut entraîner des réponses HTTP 429 (trop de demandes), ce qui peut interrompre les opérations de bot.

Pour les points de terminaison publics, tels que la récupération des données du marché, les instantanés de carnet de commandes ou les informations de ticker, les limites de taux sont généralement plus indulgentes. Le bybt permet généralement jusqu'à 120 demandes par 5 secondes par adresse IP pour les données publiques. Cela signifie que les systèmes automatisés tirant des aliments de prix en temps réel ou la profondeur du marché de la surveillance doivent espacer leurs appels de manière appropriée. Ne pas le faire peut déclencher la limitation, en particulier lorsque plusieurs robots fonctionnent à partir du même réseau.

Différences entre les limites de point final public et privé

Les critères de terminaison privés, qui nécessitent une authentification des clés de l'API, sont soumis à des contrôles plus stricts en raison de leur sensibilité. Il s'agit notamment de passer des commandes, d'annuler les métiers, de récupération des informations de position et de vérification des soldes de portefeuille. Pour les critères de terminaison privés, le recours applique généralement une limite de 60 demandes par 5 secondes par touche API . Cela signifie que chaque clé API individuelle est limitée à une moyenne de 12 demandes par seconde.

Il est crucial de noter que les limites de taux sont appliquées par clé API , et non par compte. Les commerçants exécutant des stratégies à haute fréquence peuvent envisager d'utiliser plusieurs clés d'API pour distribuer la charge. Cependant, chaque clé doit être correctement authentifiée et surveillée pour éviter une surutilisation accidentelle. De plus, certaines actions à fort impact, telles que la mise en place ou l'annulation des commandes, consomment plus de «poids» de limite de taux que les actions en lecture seule comme la récupération des positions.

Les en-têtes de limite de taux et l'utilisation de la surveillance

BYBIT renvoie des en-têtes HTTP spécifiques à chaque réponse API qui permettent aux développeurs de surveiller leur utilisation actuelle. Les en-têtes les plus importants comprennent:

• X-Ratelimit-Limit : le nombre total de demandes autorisées dans la fenêtre d'heure actuelle.
• X-Ratelimit-REMING : Le nombre de demandes restants avant d'atteindre la limite.
• X-Ratelimit-Réindépendance : L'horodatage UTC indique quand la fenêtre actuelle sera réinitialisée.

En inspectant ces en-têtes par programme, les systèmes de trading automatisés peuvent ajuster dynamiquement leur fréquence de demande. Par exemple, si X-Ratelimit-REMINGing tombe en dessous d'un seuil, le bot peut implémenter un court délai avant d'envoyer des demandes supplémentaires. Cette approche proactive aide à prévenir les interruptions de service et assure un fonctionnement plus fluide pendant les conditions du marché volatil.

Certains cadres de trading intègrent le middleware qui analyse automatiquement ces en-têtes et applique la contre-pression. Ceci est particulièrement utile lors de la gestion de plusieurs stratégies simultanées ou lors de l'interrogation de plusieurs points de terminaison simultanément.

Stratégies pour éviter d'atteindre les limites de taux

Pour maintenir les échanges automatisés ininterrompus, les commerçants devraient adopter des techniques qui minimisent les appels d'API inutiles:

• Demandes de lots dans la mesure du possible . Au lieu de passer plusieurs appels individuels pour récupérer l'état de la commande, utilisez des points de terminaison en vrac si disponibles.
• Implémentez le revers exponentiel dans la logique de réessayer. Si une erreur 429 est reçue, attendez un intervalle croissant avant de réessayer.
• Le cache a fréquemment accédé à des données telles que les informations sur les symboles ou les transactions récentes, réduisant la nécessité de se remettre à partir de l'API.
• Utilisez les flux WebSocket pour les mises à jour en temps réel. Bybit fournit des points de terminaison WebSocket pour les livres de commandes, les transactions et les mises à jour de compte, qui sont beaucoup plus efficaces que le sondage de repos répété.

Par exemple, au lieu de sonder l'API REST toutes les 100 ms pour les modifications du carnet de commandes, abonnez-vous au orderbook de la chaîne publique via WebSocket . Cela réduit considérablement le nombre de demandes tout en fournissant des mises à jour presque instantanées.

Configuration des touches API pour des performances optimales

Lors de la configuration des touches API pour le trading automatisé, une configuration appropriée est vitale. Pendant la création, assurez-vous ce qui suit:

• Activez uniquement les autorisations nécessaires: éviter d'accorder un accès «transfert» ou «retrait», sauf si vous avez absolument requis.
• Restreindre la liste blanche IP au (s) serveur exécutant le bot. Cela améliore la sécurité et empêche l'utilisation non autorisée.
• Utilisez des clés API distinctes pour différentes stratégies ou environnements (par exemple, test vs live).

Chaque clé API fonctionne selon les mêmes règles de limite de taux. La distribution des opérations à haute fréquence sur plusieurs clés peut aider à rester dans les limites. Cependant, une coordination est nécessaire pour empêcher une clé de submerger le système. Par exemple:

• Attribuez une clé pour la récupération des données du marché.
• Dédiquez une autre clé pour l'exécution de l'ordre.
• Utilisez une troisième clé pour la surveillance de la position et de l'équilibre.

Cette segmentation aide non seulement à gérer les limites de taux, mais améliore également le débogage et la surveillance.

Questions fréquemment posées

Que se passe-t-il lorsque je dépasse la limite de taux de l'API sur le recours?

Si vous dépassez la limite, Bybit renverra un code d'état HTTP 429. L'API bloquera temporairement d'autres demandes de cette clé ou IP jusqu'à ce que la fenêtre se réinitialise. Aucune pénalité permanente n'est appliquée, mais votre bot peut manquer des événements de marché critiques pendant le bloc.

Puis-je augmenter ma limite de taux d'API sur le recours?

Non, Bybit ne permet pas aux utilisateurs d'augmenter leurs limites de taux par défaut. Les clients de niveau d'entreprise ou les commerçants institutionnels peuvent contacter le support pour des arrangements spéciaux, mais les utilisateurs standard doivent travailler dans les seuils publiés.

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

Non, les connexions WebSocket fonctionnent indépendamment des limites de taux de repos. L'abonnement aux flux de données via WebSocket ne consomme pas de quotas de demande de repos, ce qui en fait une méthode préférée pour les données en temps réel.

Comment puis-je vérifier mon utilisation actuelle de l'API en temps réel?

Surveillez les en-têtes X-Ratelimit-Ratelimit et X-Ratelimit-Réindépendance dans les réponses API. Implémentez la connexion dans votre bot de trading pour suivre ces valeurs et alerter lorsque l'utilisation approche le seuil.