Limites de débit de l'API WEEX expliquées : Les chiffres que les débutants ignorent

By: WEEX|

Les limites de débit de l'API WEEX plafonnent le nombre de requêtes que votre code peut envoyer dans une fenêtre donnée — 100 ordres spot par minute, 50 ordres futures par minute, 20 appels de données de marché publics toutes les 2 secondes — et les dépasser entraîne une erreur HTTP 429 ainsi qu'un bannissement temporaire. La plupart des guides sur les limites de débit des exchanges expliquent le concept et s'arrêtent là. Celui-ci vous donne les plafonds réels de WEEX, où ils sont appliqués par IP ou par compte, et l'arithmétique qui montre à quelle vitesse un bot de débutant les atteint.

Tous les chiffres ci-dessous proviennent de la documentation de l'API Spot et Futures de WEEX, mise à jour le 14/04/2026. Les limites de débit changent avec les mises à jour du système, traitez donc les documents officiels comme la source en direct et cette page comme la carte.

Quelles sont les limites de débit de l'API WEEX, et pourquoi l'exchange les définit-il ?

Une limite de débit est un plafond sur la fréquence des requêtes. Envoyez plus d'appels que le plafond ne l'autorise dans la fenêtre de mesure et le serveur cesse de répondre — sur WEEX, avec le statut HTTP 429 Too Many Requests.

Limites de débit de l'API WEEX expliquées : Les chiffres que les débutants ignorent

La raison n'est pas l'avarice. Le moteur d'appariement d'un exchange dessert chaque utilisateur à partir d'une infrastructure partagée, et une seule boucle mal configurée interrogeant les prix 200 fois par seconde impose un coût réel sur les exécutions de tous les autres. Les limites freinent également la manipulation par spam d'ordres. Si vous avez utilisé l'API WEEX pour le trading automatisé, vous avez déjà opéré dans ces budgets, que vous l'ayez remarqué ou non.

Le cadre pratique qui aide les débutants : considérez la limite de débit comme une allocation de dépenses qui se recharge sur une minuterie, et non comme un interrupteur marche/arrêt. Votre travail consiste à concevoir un budget de requêtes, et non à réagir après que le compte a été bridé.

Limites de débit de l'API WEEX par endpoint : les chiffres qui comptent

Voici la partie que la plupart des articles sur les limites de débit ignorent. Voici les plafonds WEEX publiés par type d'activité.

MarchéOpérationLimite publiéeRythme effectif
SpotPlacer un ordre100 par minute~1 ordre toutes les 0,6s
SpotAnnuler un ordre80 par 10s, ou 200 par minute8/s en rafales, ~3,3/s soutenu
FuturesPlacer un ordre50 par minute~1 ordre toutes les 1,2s
FuturesAnnuler un ordre50 par minute~1 annulation toutes les 1,2s
Endpoints publics (données de marché)Ticker, profondeur, K-line20 par 2 secondes10 requêtes par seconde
REST FuturesPar défaut sauf indication contraire de l'endpoint10 par secondeDes dérogations par endpoint existent
RéseauNouvelle connexion REST/WS300 par 5 minutes par IP~1 nouvelle connexion par seconde, 100 max simultanées
WebSocketAbonnement au canal240 par heure par connexion~1 abonnement toutes les 15s, 100 canaux max

Quatre détails dans ce tableau piègent les gens. Premièrement, les limites d'ordres spot et futures sont différentes — 100/min contre 50/min — donc une stratégie portée d'un marché à l'autre n'héritera pas de sa marge de sécurité. Deuxièmement, l'allocation d'annulation d'ordre a deux formes : 80 par 10 secondes vous permet de faire des rafales à huit par seconde, mais 200 par minute signifie que vous ne pouvez pas maintenir ce rythme. Troisièmement, la limite de connexion est distincte de la limite de requête ; vous pouvez être bien en dessous de votre budget d'ordres et quand même être bloqué pour avoir ouvert trop de sockets, et la documentation WebSocket ajoute un plafond strict de 100 connexions simultanées par IP et 100 canaux par connexion.

Quatrièmement, le traitement par lots est l'optimisation la moins chère disponible là où elle s'applique. La page des restrictions d'accès aux futures indique qu'un ordre par lots comprenant quatre paires de trading avec dix ordres chacune compte comme une seule requête. Cela dit, les pages d'endpoints individuels publient leurs propres plafonds et poids par requête, et ils ne sont pas toujours d'accord avec les conseils généraux — vérifiez donc l'endpoint spécifique que vous appelez plutôt que de supposer qu'un lot est toujours gratuit.

WEEX indique également que la limite de débit de chaque endpoint est calculée indépendamment et marquée sur sa propre page de documentation. Ne supposez pas un pool global. Spot V3 en particulier mesure les données de marché par poids IP par endpoint plutôt que par un nombre de requêtes plat, donc le chiffre de poids sur chaque page d'endpoint est le nombre qui vous lie.

Les limites WEEX sont-elles appliquées par IP ou par compte ?

Les deux, selon ce que vous appelez — et confondre les deux est la source la plus courante de tickets "Je suis sous la limite, pourquoi suis-je bridé ?".

Les requêtes portant une clé API valide sont mesurées par rapport à la clé ou au compte (userId). Les requêtes sans clé — données de marché publiques — sont mesurées par rapport à votre adresse IP publique.

L'API spot V3 affine encore cela. Chaque endpoint sauf le placement d'ordre est limité en débit par IP en utilisant un système de poids, où les endpoints plus lourds consomment plus de votre budget par appel. Les endpoints de placement d'ordre sont mesurés sous un type ORDERS séparé lié à votre compte, et selon la documentation des restrictions d'accès spot, ils ne consomment pas de poids IP — bien que certaines pages d'endpoints individuels listent toujours un poids IP, lisez donc la page de l'endpoint que vous appelez réellement.

La conséquence opérationnelle est facile à manquer : exécuter trois bots depuis une VM cloud partage un budget IP pour les données de marché, peu importe le nombre de clés API distinctes que vous détenez. Inversement, déplacer le flux d'ordres vers un second serveur ne fait rien pour un plafond d'ordres au niveau du compte.

Prix de --

--
--
--

Comment lire les en-têtes de limite de débit WEEX avant d'atteindre 429

Chaque réponse vous indique combien de budget il vous reste. Les débutants ne lisent presque jamais ces en-têtes, c'est pourquoi le premier signe de problème est généralement une erreur plutôt qu'un avertissement.

En-têteVous indique
X-USED-WEIGHT-(intervalNum)(intervalLetter)Poids consommé par votre IP dans la fenêtre
X-REMAINING-WEIGHT-(intervalNum)(intervalLetter)Poids encore disponible pour votre IP
X-ORDER-COUNT-(intervalNum)(intervalLetter)Ordres que votre compte a placés dans la fenêtre
X-ORDER-REMAINING-(intervalNum)(intervalLetter)Ordres que votre compte peut encore placer

Les lettres d'intervalle sont S, M, H, D pour seconde, minute, heure et jour, donc X-USED-WEIGHT-1M est le poids que votre IP a brûlé au cours de la dernière minute. Enregistrez-les sur chaque réponse et vous convertissez une contrainte invisible en une jauge contre laquelle vous pouvez brider — faites une pause lorsque le poids restant tombe en dessous de, disons, 20% plutôt que d'attendre que le serveur dise non.

Ce qu'un 429 sur WEEX vous coûte réellement

Dépasser la limite n'est pas un nouvel essai gratuit. La requête échoue avec 429, et la documentation spot indique que la violation des limites entraîne un bannissement de 10 secondes. Dix secondes sont une éternité si vous détenez une position à effet de levier et que votre appel d'annulation d'ordre est celui qui a été rejeté.

Le risque de second ordre est pire. WEEX note que les comptes déclenchant des contrôles de risque de la plateforme — y compris des requêtes invalides de haute fréquence soutenues — peuvent voir leurs permissions API automatiquement désactivées, avec une réactivation nécessitant un ticket de support. Une boucle de réessai qui martèle un endpoint défaillant ne se fait pas seulement brider ; cela peut ressembler à de l'abus.

Deux modes de défaillance connexes produisent des erreurs que les débutants interprètent à tort comme une limitation de débit. Une requête dont le ACCESS-TIMESTAMP s'écarte de plus de 30 secondes du temps serveur est rejetée purement et simplement (erreur -1046), ce qui sur une horloge décalée ressemble à une défaillance intermittente aléatoire. Et une connexion WebSocket ouverte sans en-tête User-Agent est bloquée par le pare-feu avec un 403, pas un 429 — la solution est un en-tête, pas une boucle plus lente.

Quatre façons dont les débutants brûlent la limite de débit de l'API WEEX

L'arithmétique ici est la partie utile, car les limites ne semblent généreuses que jusqu'à ce que vous multipliiez.

Interroger chaque symbole individuellement. Demander des tickers pour 50 symboles une fois par seconde représente 50 appels distincts par seconde, cinq fois le rythme de 10 par seconde qu'une allocation publique de 20 par 2 secondes permet — et est définitivement au-dessus. La plupart des endpoints de données de marché acceptent une liste de symboles, donc le même travail est souvent un seul appel. Mieux encore, déplacez-le vers un flux WebSocket qui pousse les mises à jour au lieu que vous demandiez.

Re-coter une grille trop vite. Une grille à 20 niveaux qui annule et remplace chaque niveau toutes les 10 secondes génère 120 placements par minute. Cela efface le plafond spot de 100 et plus que double le plafond futures de 50. Élargir l'intervalle de re-cotation à 30 secondes place la même stratégie à l'intérieur des deux.

Tempêtes de reconnexion. Un client WebSocket qui tombe et réessaie immédiatement dans une boucle serrée peut consommer le budget IP de 300 connexions par 5 minutes en moins d'une minute. Chaque reconnexion nécessite un backoff et un délai de gigue, pas un réessai instantané.

Réessayer le 429 lui-même. L'erreur la plus coûteuse est de traiter le 429 comme une erreur réseau transitoire et de réessayer immédiatement. WEEX est explicite sur le fait qu'à la réception d'un 429, vous êtes responsable de vous arrêter. Le backoff exponentiel — doublez l'attente à chaque fois, plafonnez-le, ajoutez de la gigue — est la réponse standard et celle que l'exchange attend.

Comment construire un bot qui reste sous les limites de débit de l'API WEEX

Concevez le budget avant d'écrire la stratégie. Décidez combien d'ordres par minute la logique nécessite réellement, comparez-le aux plafonds du tableau ci-dessus, et laissez 30 à 40 % de marge pour les pics de volatilité lorsque votre bot veut naturellement trader davantage.

Ensuite, divisez le transport par tâche. REST pour les actions discrètes — placer, annuler, interroger les soldes. WebSocket pour tout ce que vous interrogeriez autrement : mises à jour du carnet d'ordres, tickers, exécutions. Déplacer les données de marché vers un flux supprime généralement la majorité du volume de requêtes d'un bot naïf en un seul changement, et cela réduit la latence en même temps.

Ajoutez un limiteur de débit côté client plutôt que de compter sur le serveur pour vous dire non. Un seau à jetons dimensionné légèrement en dessous de la limite publiée signifie que votre code met en file d'attente son propre excès au lieu de collecter des bannissements. Enregistrez chaque 429 avec son endpoint et son horodatage afin de pouvoir voir quel appel est réellement le contrevenant — ce n'est souvent pas celui que vous soupçonnez.

Enfin, gardez les permissions serrées pendant que vous expérimentez. Limitez les clés API à ce dont le bot a besoin, activez la liste blanche IP, et rappelez-vous que les clés nouvellement créées ou modifiées prennent environ 15 minutes pour se propager dans le système, donc une erreur d'authentification immédiate après la création de la clé est généralement une propagation plutôt qu'une erreur de codage. Les détails au niveau de l'endpoint pour chaque marché se trouvent dans la FAQ de l'API Spot WEEX et la FAQ de l'API Futures WEEX.

Le point à retenir sur les limites de débit de l'API WEEX

Les limites de débit de l'API WEEX ne sont pas un obstacle à contourner ; ce sont une contrainte de conception qui sépare un bot qui survit à une session volatile de celui qui se fait bannir pendant celle-ci. Apprenez les trois chiffres qui régissent votre stratégie — votre plafond d'ordres, votre plafond de données publiques et votre plafond de connexion — instrumentez les en-têtes de réponse afin de pouvoir voir votre budget restant, et reculez correctement lorsque vous obtenez un 429. C'est l'essentiel du travail.

Prêt à tester une stratégie contre des endpoints réels ? Créez une clé API dans votre compte WEEX, commencez avec des permissions en lecture seule et un seul symbole, et confirmez que votre comptabilité de requêtes est correcte avant d'activer les portées de trading.

FAQ

1. Que se passe-t-il si je dépasse la limite de débit de l'API WEEX ?

La requête échoue avec le statut HTTP 429 Too Many Requests, et la documentation spot indique que la violation des limites entraîne un bannissement de 10 secondes. Des requêtes invalides de haute fréquence soutenues peuvent également déclencher des contrôles de risque de la plateforme, ce qui peut désactiver les permissions API jusqu'à ce que vous contactiez le support.

2. Les limites de débit de l'API WEEX sont-elles par adresse IP ou par clé API ?

Les deux. Les endpoints qui nécessitent une clé API sont mesurés par rapport au compte, tandis que les endpoints publics sans clé sont mesurés par rapport à votre IP. Dans l'API spot V3, le placement d'ordre est plafonné par compte (userId) sous le type ORDERS, et tout le reste est plafonné par poids IP.

3. Combien d'ordres par minute puis-je placer sur WEEX ?

À partir de la documentation mise à jour le 14/04/2026, le spot autorise 100 placements d'ordres par minute et les futures autorisent 50 par minute. Les annulations spot sont plafonnées à 80 par 10 secondes ou 200 par minute ; les annulations futures à 50 par minute.

4. WebSocket compte-t-il contre la limite de débit REST de WEEX ?

Pas directement, mais WebSocket a ses propres budgets : 300 requêtes de connexion REST/WS par 5 minutes par IP avec un maximum de 100 connexions simultanées, et 240 abonnements aux canaux par heure par connexion avec un maximum de 100 canaux ouverts à la fois. Déplacer les données de marché vers WebSocket est le moyen le plus efficace de réduire le volume de requêtes REST.

5. Pourquoi est-ce que je reçois des erreurs alors que je suis sous la limite de débit ?

Vérifiez trois choses avant de supposer un bridage. Un horodatage s'écartant de plus de 30 secondes du temps serveur est rejeté comme -1046. Une connexion WebSocket sans en-tête User-Agent renvoie 403. Et une clé API nouvellement créée ou modifiée prend environ 15 minutes pour se propager à l'échelle du système.

6. Les ordres par lots comptent-ils comme une seule requête sur WEEX ?

La page des restrictions d'accès aux futures indique qu'un ordre par lots couvrant quatre paires de trading avec dix ordres chacune compte comme une seule requête, ce qui fait du traitement par lots un moyen bon marché d'étirer un budget limité. Les pages d'endpoints individuels publient cependant leurs propres plafonds et poids par requête, et ils ne correspondent pas toujours aux conseils généraux — vérifiez par rapport à l'endpoint que vous appelez avant de dimensionner un lot.

Avertissement sur les risques

Les actifs crypto sont très volatils et leur trading peut entraîner une perte partielle ou totale de capital. L'API et le trading automatisé ajoutent des risques que le trading manuel n'a pas : un bannissement pour limite de débit peut vous laisser incapable d'annuler ou de fermer une position lors d'un mouvement rapide, une défaillance de reconnexion peut laisser une stratégie aveugle aux exécutions, et une erreur de codage peut exécuter une taille non intentionnelle en quelques secondes. Les futures à effet de levier amplifient chacun de ces résultats et peuvent conduire à la liquidation. Les clés API compromises sont un risque de garde direct — limitez les permissions au minimum nécessaire, activez la liste blanche IP, et ne partagez jamais de clés ou de secrets. Les limites de débit, les endpoints et les codes d'erreur peuvent changer avec les mises à jour du système ; vérifiez toujours par rapport à la documentation actuelle de l'API WEEX avant de déployer. 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

Cryptos populaires

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