Limites de débit de l'API WEEX : où les bots atteignent réellement le code 429
La plupart des intégrations de l'API WEEX qui échouent en production ne le font pas à cause des signatures. Elles échouent parce que le bot traite la "limite de débit" comme un chiffre unique, alors que WEEX gère deux budgets indépendants — un budget de poids par IP et un budget d'ordres par compte — qui se rechargent sur des horloges différentes et sont signalés dans des en-têtes de réponse différents. Si vous vous trompez, vous écopez d'une erreur HTTP 429 et d'un bannissement de 10 secondes, généralement au moment précis où la volatilité rend vos exécutions cruciales.
Ceci est une carte consolidée des règles de limite de débit de l'API WEEX telles qu'elles existent en juillet 2026, extraites de la documentation spot et futures, et vérifiées par rapport au point de terminaison exchangeInfo des futures en direct. Elle couvre également ce que la documentation n'explique pas : combien de polling ces chiffres vous permettent réellement d'effectuer.
Les limites de débit de l'API WEEX en un coup d'œil
Le tableau ci-dessous fusionne les règles actuellement dispersées sur quatre surfaces de documentation WEEX : restrictions d'accès spot, poids des points de terminaison futures, aperçu WebSocket et liste des erreurs du centre d'aide.
| Limite | Portée | S'applique à | Signalé dans l'en-tête | Résultat de l'infraction |
|---|---|---|---|---|
| REQUEST_WEIGHT | Par adresse IP | Chaque point de terminaison sauf le placement d'ordres | X-USED-WEIGHT-1M / X-REMAINING-WEIGHT-1M | HTTP 429 + bannissement 10s |
| ORDERS | Par compte (userId) | Placement d'ordres simples et par lots uniquement | X-ORDER-COUNT-10S, X-ORDER-COUNT-1M / X-ORDER-REMAINING-* | HTTP 429 + bannissement 10s |
| Connexions WS | Par IP | Nouveaux handshakes WebSocket | — | Connexion refusée |
| Abonnements WS | Par connexion | Opérations SUBSCRIBE / UNSUBSCRIBE | — | Opération rejetée |
Deux détails dans ce tableau causent plus d'incidents que tout le reste.
Premièrement, le placement d'ordres ne consomme aucun poids IP — WEEX renvoie 0 dans le compteur de poids IP pour ces appels. Deuxièmement, et c'est le piège, l'annulation et la consultation d'ordres sont toujours limitées par IP. Une boucle de market-making qui annule et replace des cotations dépense donc les deux budgets à la fois, et les annulations sont le côté qui draine silencieusement le pool IP.

Les chiffres officiels ne sont nulle part en prose. WEEX les publie dans le tableau rateLimits renvoyé par exchangeInfo — /capi/v3/market/exchangeInfo sur https://api-contract.weex.com pour les futures, et /api/v3/exchangeInfo pour le spot. Lisez ce tableau au démarrage plutôt que de coder des constantes en dur.
Les chiffres en direct, et pourquoi la documentation montre des valeurs différentes
Voici la réponse rateLimits des futures en direct, récupérée le 27 juillet 2026, à côté des exemples de valeurs imprimés dans la propre page de documentation exchangeInfo de WEEX :
| Champ | Point de terminaison en direct (27 juil 2026) | Exemple de page doc |
|---|---|---|
| REQUEST_WEIGHT | 500 par 10 minutes | 2 000 par 10 secondes |
| ORDERS | 300 par 1 minute | 5 par 10 secondes |
Ce ne sont pas de petites différences — l'exemple implique environ 200 de poids par seconde, la réponse en direct en autorise environ 0,83. Les valeurs de la documentation sont des exemples de réponse fictifs, pas une allocation publiée, et quiconque a scrappé la page de doc pour dimensionner son budget de requêtes a construit sur un chiffre qui est faux de plus de deux ordres de grandeur. C'est l'argument le plus fort pour lire exchangeInfo au moment de l'exécution : WEEX peut changer ces valeurs, et seul le point de terminaison vous dit la vérité.
En analysant les chiffres des futures en direct, le plafond pratique est inconfortable :
- 500 de poids ÷ 600 secondes = une requête de poids-1 toutes les 1,2 secondes soutenue, par IP.
- Interroger un point de terminaison de poids-1 une fois par seconde — le défaut dans la plupart des bots tutoriels — brûle 600 de poids par 10 minutes et vous fait dépasser le plafond avant la onzième minute.
- 300 ordres par minute = 5 ordres par seconde soutenus, par compte.
Le budget d'ordres est généreux. Le budget de poids IP ne l'est pas. Si votre architecture suppose un polling REST pour les données de marché, cette supposition est ce qui casse tout.
Comment lire les en-têtes de limite de débit WEEX
WEEX construit les noms d'en-têtes à partir de l'intervalle, en utilisant S, M, H, D pour seconde, minute, heure et jour. Donc X-USED-WEIGHT-1M est le poids consommé par votre IP dans la fenêtre actuelle d'une minute, et X-ORDER-COUNT-10S sont les ordres passés par votre compte dans la fenêtre actuelle de dix secondes.
| En-tête | Ce qu'il vous indique |
|---|---|
X-USED-WEIGHT-(n)(letter) | Poids que votre IP a dépensé dans cette fenêtre |
X-REMAINING-WEIGHT-(n)(letter) | Poids restant à votre IP |
X-ORDER-COUNT-(n)(letter) | Ordres que votre compte a passés dans cette fenêtre |
X-ORDER-REMAINING-(n)(letter) | Ordres restants à votre compte |
Analysez X-REMAINING-* sur chaque réponse et appliquez un throttling basé dessus. Attendre un 429 pour vous dire que vous étiez trop rapide est une conception qui garantit que vous serez trop rapide — et WEEX est explicite sur le fait qu'après un 429, vous êtes responsable de vous arrêter, pas de réessayer. Notez également que le chemin des ordres futures rapporte à la fois un compteur d'ordres de 10 secondes et de 1 minute, donc une rafale qui vide le plafond par minute peut toujours déclencher la fenêtre plus courte.
Bon à savoir avant de déboguer la mauvaise chose : plusieurs erreurs ressemblent à du throttling mais n'en sont pas. La liste des codes d'erreur API de WEEX sépare le 429 (fréquence de requête dépassée) du 40008 (horodatage de requête expiré — la signature est valide pendant 30 secondes) et 40018 (requête IP illégale, ce qui signifie que votre IP appelante n'est pas sur la liste blanche de la clé). Une horloge qui dérive au-delà de 30 secondes produit un flux constant de rejets qui est étonnamment souvent mal interprété comme un problème de limite de débit.
Prix de --
Que se passe-t-il lorsque vous atteignez 429 sur l'API WEEX
La requête échoue avec le statut HTTP 429, et les requêtes continues valent un bannissement de 10s. La page des Restrictions d'Accès de WEEX énonce clairement l'obligation : lorsque vous recevez un 429, vous devez arrêter de demander et ne pas abuser de l'API.
Dix secondes semblent survivables. En pratique, ce sont les dix pires secondes que vous passerez, car les limites de débit sont atteintes pendant la volatilité — le moment même où une couverture doit être mise en place ou un stop doit bouger. La posture correcte est un token bucket côté client dimensionné à partir des valeurs exchangeInfo en direct avec environ 20 % de marge, plus un backoff exponentiel sur tout 429 qui passerait à travers. Réessayer immédiatement transforme un bannissement de 10 secondes en un bannissement roulant.
Construire un bot qui reste sous les limites de l'API WEEX
La solution pour un budget de poids IP serré est architecturale, pas tactique : arrêtez de faire du polling pour tout ce qu'un flux peut fournir.
Le WebSocket spot de WEEX fonctionne sur wss://ws-spot.weex.com/v3/ws/public et wss://ws-spot.weex.com/v3/ws/private, avec ses propres limites séparées — 300 demandes de connexion par IP par 5 minutes, un maximum de 100 connexions simultanées par IP, 100 canaux par connexion, et 240 opérations d'abonnement par heure par connexion. Cela représente 10 000 emplacements de canaux par IP, ce qui est plus de données de marché que presque n'importe quelle stratégie n'en a besoin, et rien de tout cela ne touche votre poids REST.
La règle du heartbeat compte ici. Le serveur envoie ping et attend un PONG ; les connexions qui ne répondent pas plus de 10 fois sont terminées. Un client qui ne se reconnecte qu'à la fermeture du socket, et jamais sur des pongs manqués, restera sur un flux mort pendant que sa logique trade tranquillement des prix périmés.
Une configuration pratique sur WEEX ressemble à ceci :
- Créez une clé API sous Compte → Gestion API, et liez une liste blanche IP. Les clés non liées sont la cause la plus fréquente d'un compte compromis survivant assez longtemps pour poser problème.
- Appelez
exchangeInfoau démarrage, lisezrateLimits, et dimensionnez votre token bucket à partir de la réponse — jamais à partir d'une constante dans votre fichier de configuration. - Déplacez toutes les données de marché vers WebSocket. Réservez REST pour l'état du compte, le placement d'ordres et la réconciliation.
- Séparez les deux budgets dans le code. Un limiteur pour le poids IP (incluant annulations et requêtes), un second pour le nombre d'ordres. Un seul limiteur partagé soit bridera votre flux d'ordres inutilement, soit dépassera votre poids.
- Utilisez les points de terminaison d'ordres par lots là où la stratégie le permet. Ils comptent toujours contre
ORDERS, mais ils réduisent les allers-retours et la latence. - Réconciliez sur une minuterie, pas à chaque exécution. Les requêtes de position et de solde sont des points de terminaison de poids-1 qui s'additionnent rapidement lorsqu'ils sont déclenchés par événement.
Si vous décidez encore si une approche pilotée par API convient, l'aperçu de WEEX sur le support du trading API couvre la décision REST versus WebSocket avant que vous ne vous engagiez dans une architecture.
Ce qui compte le plus
De tout ce qui précède, un chiffre régit la conception : l'allocation de poids IP des futures en direct de 500 par 10 minutes. C'est assez restrictif pour que toute boucle de données de marché par polling REST soit disqualifiée, ce qui signifie que les règles de limite de débit de l'API WEEX ne sont pas vraiment un problème de throttling à régler — ce sont un signal que la plateforme attend des clients en streaming. Construisez de cette façon dès le départ et les 429 cessent pour la plupart d'être un sujet.
Vérifiez chaque chiffre ici par rapport à exchangeInfo avant de passer en direct. Les limites sont des paramètres opérationnels, et les exchanges les changent sans préavis.
FAQ
1. Quelle est la limite de débit de l'API WEEX ?
WEEX impose deux limites : un budget REQUEST_WEIGHT par adresse IP couvrant tous les points de terminaison sauf le placement d'ordres, et un budget ORDERS par compte couvrant le placement d'ordres simples et par lots. Au 27 juillet 2026, le point de terminaison exchangeInfo des futures en direct renvoie 500 de poids par 10 minutes et 300 ordres par minute. Lisez le point de terminaison plutôt que de faire confiance à un chiffre publié, y compris celui-ci.
2. La limite de débit de l'API WEEX est-elle par IP ou par clé API ?
Par IP pour les points de terminaison pondérés — WEEX déclare que ces limites sont basées sur l'IP, pas sur la clé API ou l'UID. Le placement d'ordres est l'exception : il est limité par compte (userId). Exécuter plusieurs clés depuis un serveur ne multiplie pas votre allocation de poids.
3. Que signifie HTTP 429 sur WEEX et combien de temps dure le bannissement ?
429 signifie que votre fréquence de requête a dépassé la limite. WEEX applique un bannissement de 10 secondes et s'attend à ce que vous arrêtiez d'envoyer des requêtes plutôt que de réessayer immédiatement.
4. Les demandes d'annulation d'ordres comptent-elles dans la limite de débit des ordres ?
Non. Seul le placement d'ordres simples et par lots tombe sous la limite ORDERS. L'annulation et la consultation d'ordres sont limitées par le poids IP, c'est pourquoi les stratégies gourmandes en annulations épuisent le budget IP en premier.
5. Comment vérifier mon quota restant de l'API WEEX ?
Lisez les en-têtes de réponse. X-REMAINING-WEIGHT-1M montre le poids IP restant dans la minute actuelle, et X-ORDER-REMAINING-10S et X-ORDER-REMAINING-1M montrent la capacité d'ordres restante pour votre compte.
6. Quelles sont les limites WebSocket de WEEX ?
300 demandes de connexion par IP par 5 minutes, jusqu'à 100 connexions simultanées par IP, un maximum de 100 canaux par connexion, et 240 opérations d'abonnement par heure par connexion. Manquez plus de 10 pings serveur et la connexion est fermée.
7. Pourquoi ma requête API WEEX échoue-t-elle même à faible volume ?
Vérifiez l'erreur 40008 avant de supposer un throttling. Les requêtes signées sont valides pendant 30 secondes, donc une horloge serveur décalée de plus de 30 secondes par rapport à l'heure de l'exchange produit des rejets constants qui ressemblent à un problème de limite de débit. L'erreur 40018 pointe vers une inadéquation de la liste blanche IP.
Avertissement sur les risques
Les actifs crypto sont volatils et le trading piloté par API peut entraîner une perte partielle ou totale des fonds. Les systèmes automatisés aggravent cette exposition : un client limité ou déconnecté peut échouer à placer un stop, annuler une cotation périmée ou fermer une position à effet de levier pendant que le marché évolue contre lui, et un bannissement de 10 secondes pendant un pic de volatilité suffit à transformer un drawdown gérable en liquidation. Les positions futures comportent un risque de levier et peuvent être liquidées en totalité. Les clés API comportent des risques de garde et opérationnels — une clé sans liste blanche ou avec des permissions excessives peut être utilisée pour vider ou abuser d'un compte, donc restreignez les permissions, liez une liste blanche IP, et n'accordez jamais de droits de retrait à un bot de trading. Les limites de débit, les poids des points de terminaison et les paramètres de contrat sont sujets à changement sans préavis ; vérifiez-les par rapport aux points de terminaison en direct avant de déployer du capital. Rien ici n'est un conseil en investissement.
Ce contenu est fourni à titre informatif uniquement et ne constitue pas un conseil financier, d'investissement, juridique ou fiscal. Les événements, récompenses, promotions en ligne ou informations mentionnées ici ne doivent pas être considérés comme une recommandation, une sollicitation ou une invitation à acheter, vendre, trader ou effectuer toute autre opération sur des actifs crypto. Les actifs crypto sont très volatils et peuvent entraîner des pertes. La disponibilité des services, produits et événements liés à WEEX peut varier selon les régions. Veuillez vous assurer que votre participation respecte les lois et réglementations locales applicables.
Vous pourriez aussi aimer

Le hard fork Purley de Polygon est activé : quels changements pour POL et la sécurité du réseau ?

Prévision du cours de l’action ANT : ce que les données peuvent et ne peuvent pas vous apprendre après le premier jour

Point sur le piratage de Binance : 2,85 Md $ sur 6,3 Md $ gelés, audience du tribunal le 1er décembre

Introduction en Bourse d’Anthropic fixée à 83 $ : levée record de 81,3 Md $ et prochaines étapes

Résultats de NVIDIA au T3 2027 : le chiffre d’affaires atteint 115,8 Md $, tandis que les questions sur la direction persistent

Division d’actions Sandisk par 8 : guide de trading SNDK du 20/11

Ondo lance un token lié au S&P 500 avec un coussin de protection à la baisse de 100 % : quel est le piège ?

Approbation de Backpack par la CFTC : ce que signifient les licences DCM et DCO

Anthropic approuvée pour une cotation au Nasdaq : quelles sont les prochaines étapes ?

L’ETF XRP de Franklin détient 293M XRP : pourquoi le XRP reste-t-il sous 1 $ ?

Comment acheter l’action ANT dès le premier jour : ce qui est confirmé

Rumeurs de retour de Jensen Huang : pétition, cellule de crise et réponse de Nvidia

Nebius réduit ses prévisions de chiffre d’affaires pour 2026 : les retards des centres de données menacent-ils NBIS ?

Hausse du token JACKET de plus de 1 000 % en 24 heures : ce qui est confirmé après la démission de Jensen Huang

Pourquoi l’action Nebius a-t-elle chuté malgré une hausse de 571 % de son chiffre d’affaires ? Résultats du T3 de NBIS expliqués

Résultats des élections de mi-mandat et crypto : qui contrôle désormais la politique des cryptomonnaies ?

DTCC apporte les titres tokenisés à Solana : la demande de SOL va-t-elle augmenter en 2027 ?

100e lancement d’Electron par Rocket Lab : fenêtre du 14/11, détails de la mission et perspectives de l’action RKLB

La NYSE choisit Avalanche pour le règlement : ce que cela signifie pour AVAX

Bitcoin après un IPC supérieur aux attentes : pourquoi les probabilités d’une hausse des taux en décembre ont atteint 85 %

Puis-je récupérer des cryptomonnaies envoyées sur WEEX via le mauvais réseau blockchain ?

Polygon propose un hard fork pour récupérer 70,49M POL

DTCC sur Canton : la tokenisation de Wall Street fera-t-elle grimper la demande de CC ?

Lettre de non-action de Canton Coin : 5 faits sur lesquels repose la protection de la SEC

USOE est-il légitime ? Ce qu’affirme le site, ce qu’ont découvert les sources indépendantes et ce qui manque encore

Qu’est-ce que le crypto-actif Project Cortex (XTX) ? Comment identifier le jeton derrière ce nom tendance

Piratage de Binance expliqué : faits confirmés, points contestés et mesures à prendre dès maintenant

Sécurité des portefeuilles chauds : les enseignements de l’incident Binance

Arnaques après le piratage de Binance : repérer les fausses offres de remboursement et de récupération







