Limites de débit de l’API WEEX : poids des requêtes et erreurs 429
Limites de débit de l’API WEEX : poids des requêtes et erreurs 429
Les limites de l’API WEEX dépendent du type de requête. Les API REST utilisent des poids de requête basés sur l’adresse IP et des quotas d’ordres basés sur le compte, tandis que les connexions et les abonnements WebSocket ont leurs propres limites. Pour connaître le quota applicable à votre intégration, consultez le exchangeInfo du produit, le poids de l’endpoint et les en-têtes de réponse. Si vous recevez une réponse HTTP 429, suspendez les requêtes concernées avant d’en ajuster la cadence.
Un bot peut atteindre une limite même si son propre trafic semble modeste. Des services de données de marché, des scripts de surveillance et d’autres stratégies peuvent partager son adresse IP sortante. Comprendre ce quota partagé est plus utile que d’attribuer un paramètre isolé de requêtes par seconde à chaque processus.
Quelle est la différence entre le nombre de requêtes, leur poids et les limites d’ordres ?
Les restrictions d’accès au spot et les restrictions d’accès aux contrats à terme décrivent deux quotas REST :
| Type de requête | Base du quota | Conséquence pratique |
|---|---|---|
| Données de marché, requêtes de compte et autres endpoints ne servant pas à passer des ordres | Poids des requêtes pour l’adresse IP sortante | Les applications qui partagent l’adresse IP doivent coordonner leur trafic. |
| Passage d’ordres | Le userId du compte et son quota ORDERS | Les appels consomment le quota d’ordres documenté. Ces requêtes de passage d’ordres ne consomment pas le poids IP. |
Le poids ne se résume pas au nombre d’appels. Une requête dont le poids est de 10 utilise 10 unités de poids, et le poids de certains endpoints varie selon les paramètres de la requête. Vingt appels peuvent donc consommer des quantités différentes selon les endpoints utilisés.
Le passage d’ordres au comptant, qu’il s’agisse d’ordres individuels ou groupés, utilise le quota d’ordres. Les annulations et les requêtes d’ordres restent soumises aux limites IP. Changer de clés API ne donne pas à la même application un nouveau quota IP.
Où consulter le quota actuel ?
Le spot et les contrats à terme disposent de endpoints d’informations de marché distincts :
| Produit | Adresse de la requête |
|---|---|
| Spot | GET https://api-spot.weex.com/api/v3/exchangeInfo |
| Contrats à terme | GET https://api-contract.weex.com/capi/v3/market/exchangeInfo |
Recherchez rateLimits dans la réponse et examinez ensemble ses quatre champs. rateLimitType identifie le quota, interval et intervalNum définissent la fenêtre temporelle, et limit indique le quota pour cette fenêtre.
Par exemple, une réponse spot consultée le 04/11/2026 indiquait un REQUEST_WEIGHT de 500 par période de 10 secondes et un quota ORDERS de 100 par période de 10 secondes. Le premier chiffre représente des unités de poids ; le second, un quota d’ordres. Ces valeurs décrivent un instantané de cette configuration spot. Elles ne doivent pas être reprises pour les contrats à terme ni considérées comme des constantes permanentes dans votre application.
Interrogez l’endpoint des contrats à terme pour connaître leurs limites. Si sa réponse contredit la FAQ ou la documentation de l’endpoint, conservez la réponse ainsi que l’heure de la requête afin que l’assistance API puisse confirmer la règle avant toute modification du trafic en production.
Suivre l’utilisation à l’aide des en-têtes de réponse pendant l’exécution de l’application
Les réponses IP indiquent X-USED-WEIGHT-(intervalNum)(intervalLetter) et X-REMAINING-WEIGHT-(intervalNum)(intervalLetter) pour le poids utilisé et le poids restant. Par exemple, X-USED-WEIGHT-1M correspond au poids utilisé par l’adresse IP actuelle sur une fenêtre d’une minute.
Le passage d’ordres utilise X-ORDER-COUNT-(intervalNum)(intervalLetter) et X-ORDER-REMAINING-(intervalNum)(intervalLetter). Enregistrez les noms d’intervalles effectivement renvoyés afin de déterminer quelle limite l’application est sur le point d’atteindre.
Lorsque plusieurs services partagent une adresse IP ou un compte, envisagez de gérer leur quota de façon centralisée. En réservant de la capacité pour les requêtes d’ordres, les annulations et la reprise après incident, vous donnez à ces opérations une marge de manœuvre lorsque le trafic de données de marché augmente.
Comment récupérer après une réponse HTTP 429 ?
Suspendez la file de requêtes qui a atteint la limite et examinez les en-têtes de réponse ainsi que la fenêtre temporelle. Augmentez ensuite progressivement les délais entre les tentatives, en ajoutant une part d’aléatoire pour éviter que les processus ne reprennent tous en même temps et atteignent immédiatement la même limite. Choisissez les délais en fonction de la fenêtre applicable plutôt que d’utiliser une valeur fixe pour toutes les requêtes.
Remontez ensuite à l’origine du trafic. Recherchez les interrogations répétées inutilement, les requêtes complètes superflues ou les bots qui partagent une adresse IP tout en suivant leurs quotas séparément. Ralentir un seul processus peut ne pas réduire le trafic total.
Les restrictions d’accès officielles indiquent qu’un dépassement de limite renvoie 429 et que des infractions répétées entraînent un bannissement de 10 secondes. Cette durée de bannissement ne garantit pas que le service sera rétabli après une attente fixe de 10 secondes. Si une requête d’ordre expire également ou si son résultat n’est pas clair, vérifiez son statut avant de la renvoyer afin d’éviter un doublon.
Quelles limites WebSocket sont distinctes ?
La documentation WebSocket du spot et des contrats à terme indique 300 demandes de connexion par adresse IP toutes les cinq minutes, jusqu’à 20 connexions simultanées par adresse IP, 240 opérations d’abonnement par connexion et par heure, et jusqu’à 100 canaux par connexion.
Ces limites mesurent l’activité de connexion ou d’abonnement. Elles ne signifient pas que le serveur ne peut transmettre que 240 mises à jour de marché ou d’ordres par heure. Réutiliser les connexions, tenir à jour un registre des abonnements et gérer les signaux de maintien de connexion réduit les tentatives de connexion et les abonnements inutiles. Appliquez également un délai exponentiel lors de la reconnexion après une défaillance.
Ces quotas restent importants lorsque vous utilisez CCXT ou un SDK, en particulier pour plusieurs applications partageant une adresse IP ou un compte. Si les limites observées ne correspondent pas à vos attentes, utilisez les liens d’assistance de la FAQ officielle de l’API. Indiquez l’endpoint, l’horodatage, le code d’état et les en-têtes de réponse expurgés des données sensibles afin de faciliter le diagnostic du problème.