API de Copy Trading WEEX : Endpoints, limites et 5 codes d'erreur

L'API de copy trading WEEX a été lancée le 23 juin 2026 (UTC+8). Elle est plus restreinte et plus stricte qu'une API futures classique, ce qui rend la lecture attentive des détails indispensable avant d'écrire le moindre code. Un lead trader dispose d'une clé dédiée, ne peut pas toucher au spot, ne peut pas trader de paires en dehors de la liste blanche de copy trading, et voit ses comportements de take-profit et stop-loss limités à un seul format. Les followers bénéficient d'une fonctionnalité que peu d'échanges proposent : un endpoint REST pour configurer leur propre copie, incluant les limites de slippage et l'effet de levier par symbole.

Ce guide couvre les fonctionnalités réelles de l'API de copy trading, la liste des endpoints des deux côtés, les plages de paramètres réelles pour la gestion des risques des followers, les codes d'erreur qui bloqueront votre première intégration, et comment cette interface se compare à ce que proposent Binance et Bybit.

Ce que l'API de copy trading WEEX peut et ne peut pas faire

L'API de copy trading est une interface dédiée aux futures, divisée en deux rôles. Un lead trader passe des ordres avec une clé API de Copy Trading dédiée, et WEEX transmet automatiquement les signaux d'exécution aux followers — vous n'avez jamais à gérer la logique de distribution vous-même. Un follower utilise une clé API classique pour configurer et contrôler la relation de copie.

Les fonds, les positions et le ratio de risque du compte de copy trading sont isolés du compte futures classique. Cette isolation est utile sur le plan opérationnel : une mauvaise journée sur votre portefeuille discrétionnaire ne peut pas liquider les positions suivies par vos followers. C'est aussi une tâche de réconciliation, car /capi/v3/account/position/allPosition renvoie les positions de copie lorsqu'il est appelé avec la clé de copie, et les positions futures classiques lorsqu'il est appelé avec une clé classique. Même chemin, réponse différente, selon les identifiants utilisés.

Qui peut créer une clé API de copy trading, et pourquoi une seule est autorisée

Seuls les comptes ayant passé la vérification des elite traders WEEX peuvent créer une clé API de Copy Trading. Vous postulez via le programme elite trader — en juillet 2026, WEEX répertorie plus de 5 000 elite traders dans plus de 150 pays et un fonds pour elite traders de 2 000 000 $. Une fois approuvée, la clé est créée dans Centre Utilisateur → Gestion API → API Copy Trading, protégée par votre mot de passe de fonds et une vérification à deux facteurs.

La limite importante pour votre plan de déploiement : une clé de copy trading par compte trader. Il n'y a pas de seconde clé pour la rotation, ce qui exclut le basculement de clés bleu/vert utilisé par la plupart des équipes quant pour une rotation sans interruption. Si vous effectuez une rotation, votre stratégie est inactive pendant la durée du changement — et tous les followers restent dans leurs positions existantes pendant cette période. Planifiez les rotations comme vous planifieriez une migration de base de données, pas comme une tâche de fond.

L'authentification suit le schéma de contrat WEEX standard : en-têtes ACCESS-KEY, ACCESS-SIGN, ACCESS-PASSPHRASE et ACCESS-TIMESTAMP, où la signature est HMAC SHA256 sur timestamp + METHOD + requestPath + "?" + queryString + body, puis encodée en Base64. Liez une liste blanche d'IP. Sur une clé pouvant déplacer le capital des followers, une clé non liée représente un risque nettement plus élevé que sur une clé futures personnelle.

Les endpoints du lead trader réutilisent la pile d'ordres futures

Il n'y a pas d'appel séparé pour "placer un trade de copie". Les lead traders utilisent les endpoints futures V3 standard et WEEX déduit l'identité de copie à partir du type de clé :

Trois endpoints de lecture sont spécifiques à la copie : GET /capi/v3/copy/trader/pairs (poids 1, sans auth), GET /capi/v3/copy/trader/openOrders (poids 10) et GET /capi/v3/copy/trader/historyOrders (poids 10, plage maximale de 90 jours, pagination par curseur via nextKeyId et nextKeyTime).

Le champ à surveiller est followCount sur chaque ordre de suivi. Il vous indique combien de followers sont attachés à cette position spécifique, et c'est la mesure la plus proche d'une évaluation en temps réel de votre propre impact sur le marché. Un lead trader entrant sur une perp altcoin peu liquide avec 3 followers et le même trader entrant avec 300 ne suivent pas la même stratégie — le second se fait concurrence à lui-même via la distribution de copie. Si votre slippage d'entrée moyen se dégrade à mesure que followCount augmente, c'est le mécanisme en cause, et la solution est le dimensionnement des positions, pas un meilleur prix limite.

Endpoints des followers : là où WEEX va plus loin que la plupart des API de copie

C'est la moitié de l'API qui est vraiment inhabituelle. Les followers obtiennent un accès en écriture à leur propre configuration de copie via REST :

Notez l'asymétrie de poids : closePos coûte 50, cinq fois plus que tout autre endpoint de l'ensemble. WEEX donne à chaque endpoint pondéré par IP un budget indépendant de 500 par 10 secondes, donc ce poids se traduit par environ 10 appels closePos par 10 secondes contre environ 50 pour les endpoints de poids 10. Une boucle qui ferme les ordres de suivi un par un se bride rapidement, et les erreurs 429 imposent de ralentir plutôt que de réessayer. Si vous débouclez un portefeuille de followers lors d'un mouvement rapide, stopCopy plus une décision sur l'exposition restante est moins coûteux que d'itérer closePos sur chaque position — et cela répondra toujours quand la boucle naïve consommera les limites de taux.

Paramètres de risque du copy trading et leurs plages réelles

POST /capi/v3/copy/follower/settings accepte soit une configuration unified sur une liste de symboles, soit un tableau per_symbol. Voici les valeurs acceptées — les chiffres qui déterminent si votre demande de configuration réussit :

Deux de ces paramètres coûteront de l'argent à quelqu'un. slippageRatio: 0 semble être la valeur la plus sûre du tableau et est la plus dangereuse : elle désactive complètement la limite de slippage, donc un ordre de copie s'exécute au prix offert par le carnet lorsque le signal arrive. Si vous voulez une protection, la plage est de 0,001 à 0,01 (0,1% à 1%) et vous devez le préciser explicitement.

Le second est un compromis de conception caché dans une note sur les valeurs autorisées : en mode per_symbol, marginType n'accepte que trader. Choisissez un contrôle granulaire par symbole et vous héritez du mode de marge du lead trader sur chaque symbole. Si vous vouliez une marge isolée sur une paire volatile alors que le lead trader utilise la marge croisée, per_symbol ne peut pas l'exprimer — unified le peut. La plupart des intégrations se tournent vers per_symbol car cela semble plus précis, et abandonnent le contrôle du mode de marge pour y parvenir.

Une autre chose qui piégera quiconque construit une boucle lecture-modification-écriture : le GET et le POST sur ce chemin ne partagent pas les noms de champs. La lecture des paramètres renvoie settingMode, maxHoldSize et takeProfitRatio ; l'écriture nécessite settingType, maxHoldQty et stopProfitRatio. Le GET nécessite aussi un traderId et renvoie un tableau — un élément pour unified, un par symbole pour per_symbol. Réinjecter l'objet de réponse directement dans le POST échouera à la validation des paramètres, donc mappez les champs explicitement plutôt que de supposer une symétrie.

Quelles paires l'API de copy trading prend en charge, et pourquoi ne pas les coder en dur

GET /capi/v3/copy/trader/pairs renvoyait 124 symboles, tous margés en USDT, lors de la vérification le 30 juillet 2026 — de BTCUSDT et ETHUSDT jusqu'aux listings plus récents comme ASTERUSDT, PUMPUSDT et STBLUSDT. Pas de contrats margés en coin, pas de spot.

Cette liste bouge, et les versions statiques circulant dans le matériel de lancement sont déjà obsolètes. Le tableau de paires statique dans le manuel de l'API de Copy Trading WEEX contient 74 tickers ; vérifié par rapport à l'endpoint en direct le 30 juillet 2026, STXUSDT et IPUSDT sont dans ce tableau mais absents de la réponse API, tandis que BTCUSDT, XRPUSDT et DOGEUSDT sont actifs mais manquants du tableau. Construisez votre liste blanche à partir du document et votre bot rejettera Bitcoin tout en acceptant deux paires qui ne se copient plus.

Interrogez plutôt l'endpoint. Il a un poids de 1 — l'appel le moins cher de toute l'interface de copy trading — et ne nécessite aucune authentification, donc il n'y a aucune bonne raison de le mettre en cache au-delà d'une session de trading. Avant d'activer une paire, vérifiez le contrat lui-même : la page perpétuelle BTC/USDT affiche le prix mark en direct, le taux de financement et le compte à rebours sur lequel vos positions de copie se régleront.

Les cinq codes d'erreur qui bloqueront votre première intégration

Le bloc 50xx est spécifique au copy trading et c'est là que le code porté échoue :

-5003 et -5004 ensemble sont le véritable risque de portage. Le code de stratégie qui réduit une position avec des take-profits partiels, ou qui définit un TP à prix limite, fonctionne bien sur une clé futures classique et échoue sur chaque appel avec une clé de copie. Le TP/SL de copie est tout ou rien et uniquement au marché, car les sorties partielles ou à prix limite ne peuvent pas être reflétées de manière cohérente chez les followers avec des tailles de position différentes. Planifiez la logique de sortie autour de cette contrainte plutôt que de la découvrir lors d'une session en direct.

Prévoyez également -1046 (timestamp expiré — synchronisez votre horloge, ne réessayez pas aveuglément), -1056 (ILLEGAL_IP, signifiant que la requête provient de l'extérieur de votre liste blanche) et -1059 (HIGH_FREQUENCY_ORDER_LIMITED, une limitation sur les rafales d'ordres qui est distincte du budget de poids et facile à déclencher avec un générateur de signaux bavard). -5000 complète le bloc 50xx et vous indique simplement de contacter WEEX.

Comment l'API de copy trading WEEX se compare à Binance et Bybit

Ce que signifie "API de copy trading" varie fortement selon la plateforme, et la différence mérite d'être vérifiée avant de supposer une portabilité :

La tendance dans l'industrie est que les échanges exposent le côté lead-trader et gardent le côté follower à l'intérieur de l'application. Le fait que WEEX publie un endpoint d'écriture côté follower est la différence significative : cela signifie qu'un outil tiers, un tableau de bord de portefeuille ou une surcouche de risque peut ajuster ou arrêter une relation de copie par programmation sans scraping d'écran. Si vous construisez des outils pour les followers plutôt qu'une stratégie de lead-trader, c'est la fonctionnalité décisive, et c'est pourquoi l'API de copie vaut plus pour les intégrateurs que ce que suggère le titre "nous avons une API de copy trading".

Les détails des paramètres changent sans beaucoup de fanfare sur une interface aussi récente, donc traitez la référence officielle de l'API de copy trading comme la source de vérité et comparez-la avec votre intégration avant chaque version.

Que faire ensuite

L'API de copy trading WEEX est une interface petite et opinionnée : 10 chemins côté ordre réutilisés de l'API futures, 3 lectures de lead-trader, 7 endpoints de follower, une clé par trader, et un bloc d'erreur 50xx qui encode la plupart de ses contraintes. Les trois choses à réussir avant votre premier signal en direct sont la liste des paires (interrogez-la, ne la codez pas en dur), slippageRatio (ne le laissez jamais à 0 sauf si vous voulez dire illimité), et le TP/SL au marché sur position complète. Tout le reste est une intégration de contrat WEEX standard.

Si vous voulez être un leader plutôt qu'un intégrateur, l'API de copy trading n'est disponible qu'après approbation en tant qu'elite trader — commencez par le hub WEEX Copy Trade pour voir comment le produit se comporte dans l'interface utilisateur avant de l'automatiser, car l'API reflète ces sémantiques plutôt que de les remplacer.

FAQ

1. Qui peut utiliser l'API de copy trading WEEX ?

Seuls les comptes approuvés en tant qu'elite traders WEEX peuvent créer une clé API de Copy Trading et placer des ordres de copie par programmation. Les followers n'ont pas besoin d'une clé spéciale — ils configurent et contrôlent la copie avec une clé API classique.

2. Combien de clés API de copy trading puis-je créer ?

Une par compte trader. Il n'y a pas de seconde clé pour la rotation, donc planifiez les changements d'identifiants comme une fenêtre de maintenance programmée.

3. L'API de copy trading WEEX supporte-t-elle le trading spot ?

Non. C'est uniquement pour les futures, et seulement pour les paires sur la liste blanche de copy trading — 124 symboles margés en USDT au 30 juillet 2026. Les appels spot et les paires hors liste blanche sont rejetés.

4. Un follower peut-il changer les paramètres de copie via l'API ?

Oui. POST /capi/v3/copy/follower/settings écrit la configuration de copie, incluant le mode de dimensionnement, la quantité maximale de détention, les ratios de take-profit et stop-loss, la limite de slippage, le type de marge et l'effet de levier. Les followers peuvent aussi appeler closePos et stopCopy.

5. Pourquoi mon ordre de take-profit échoue-t-il avec une clé API de copy trading ?

Presque certainement -5003 ou -5004. Les clés de copie n'acceptent que le TP/SL sur position complète (quantity doit être 0) exécuté au marché (executePrice doit être nul ou 0). Les sorties partielles ou à prix limite sont rejetées.

6. Quelle est la limite de taux sur l'API de copy trading ?

Les endpoints de copie sont pondérés par IP, et chaque endpoint limité par IP a un budget indépendant de 500 par 10 secondes. Les poids diffèrent — closePos est à 50 contre 10 pour la plupart des autres, donc environ 10 contre 50 appels par 10 secondes. Le dépassement renvoie 429, et -1059 est une limitation séparée sur les rafales d'ordres.

7. Les fonds de copy trading sont-ils séparés de mon compte futures classique ?

Oui. Les fonds, les positions et le ratio de risque sont totalement isolés, donc les deux comptes ne peuvent pas se liquider mutuellement. Notez que /capi/v3/account/position/allPosition renvoie le compte qui correspond à la clé avec laquelle vous avez signé.

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 de copy trading WEEX ajoute des risques au-delà du trading futures ordinaire. L'effet de levier sur les positions de copie est par défaut de 10x et peut être réglé plus haut, ce qui comprime le mouvement nécessaire pour vous liquider. Régler slippageRatio à 0 supprime complètement la limite de slippage, donc les ordres de copie peuvent s'exécuter loin du prix du lead trader dans des conditions volatiles. En tant que follower, vous êtes exposé au risque de contrepartie et comportemental du lead trader, dont la stratégie peut changer sans préavis et dont les résultats passés ne prédisent pas les performances futures ; en tant que lead trader, un followCount croissant peut aggraver vos propres exécutions par l'impact sur le marché. Les systèmes automatisés ajoutent un risque opérationnel : une liste blanche de symboles obsolète, un timestamp expiré, un bannissement par limite de taux ou un code d'erreur non géré peuvent laisser des positions ouvertes sans gestion active. La limite d'une seule clé signifie qu'un identifiant compromis ou tourné vous laisse sans chemin de repli. Le copy trading ne supprime pas le besoin de dimensionner les positions que vous pourriez vous permettre de perdre. Rien ici n'est un conseil en investissement — vérifiez tous les paramètres par rapport à la documentation actuelle de l'API WEEX avant de déployer du capital, et confirmez que le service est disponible dans votre juridiction.