Limites de débit de l'API WEEX : où les bots atteignent réellement le code 429

By: WEEX|

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.

LimitePortéeS'applique àSignalé dans l'en-têteRésultat de l'infraction
REQUEST_WEIGHTPar adresse IPChaque point de terminaison sauf le placement d'ordresX-USED-WEIGHT-1M / X-REMAINING-WEIGHT-1MHTTP 429 + bannissement 10s
ORDERSPar compte (userId)Placement d'ordres simples et par lots uniquementX-ORDER-COUNT-10S, X-ORDER-COUNT-1M / X-ORDER-REMAINING-*HTTP 429 + bannissement 10s
Connexions WSPar IPNouveaux handshakes WebSocket—Connexion refusée
Abonnements WSPar connexionOpé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.

Limites de débit de l'API WEEX : où les bots atteignent réellement le code 429

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 :

ChampPoint de terminaison en direct (27 juil 2026)Exemple de page doc
REQUEST_WEIGHT500 par 10 minutes2 000 par 10 secondes
ORDERS300 par 1 minute5 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êteCe 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 :

  1. 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.
  2. Appelez exchangeInfo au démarrage, lisez rateLimits, et dimensionnez votre token bucket à partir de la réponse — jamais à partir d'une constante dans votre fichier de configuration.
  3. 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.
  4. 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.
  5. 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.
  6. 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

iconiconiconiconiconiconiconicon
Assistance client:@weikecs
Collaborations commerciales:@weikecs
Trading quantitatif/Market makers:bd@weex.com
Programme VIP:support@weex.com