Configuration d’une clé API WEEX : connecter une plateforme tierce en toute sécurité

Pour connecter une plateforme tierce à WEEX, créez une clé API WEEX dans « Compte », puis « Gestion des API », accordez-lui uniquement les autorisations dont la plateforme a besoin, puis collez la clé API, la clé secrète et la phrase secrète dans la plateforme. Si celle-ci est un courtier WEEX enregistré, un bouton « Sign In with WEEX » permet de faire la même chose sans que vous ayez à manipuler une clé. Ce guide présente les deux méthodes, une première commande en toute sécurité, les erreurs les plus courantes et les paramètres de sécurité qui déterminent les dégâts qu’une clé divulguée peut causer. Les étapes et les limites sont à jour au 7 octobre 2026.

Connexion rapide ou clé API WEEX manuelle : quelle méthode choisir ?

Utilisez Fast Connect lorsque la plateforme le propose, et une clé manuelle dans tous les autres cas.

Fast Connect est le système d’autorisation OAuth de WEEX, annoncé le 3 août 2026. Sur la plateforme partenaire, cliquez sur « Sign In with WEEX » ; vous accédez alors à la page d’autorisation de WEEX, où vous pouvez vérifier les autorisations (l’accès de trading et de lecture sont prédéfinis), puis confirmer. WEEX génère ensuite une clé API et l’envoie au serveur de la plateforme. Vous ne la voyez ni ne la copiez jamais. WEEX indique que le processus prend moins de 10 secondes.

Deux précautions s’imposent. La page d’autorisation se trouve sur www.weex.com : vérifiez donc la barre d’adresse avant d’approuver quoi que ce soit. De plus, les règles OAuth de WEEX autorisent une seule clé par utilisateur et par plateforme tierce. Pour reconnecter la même plateforme, vous devez donc d’abord supprimer l’ancienne clé.

Une clé manuelle fonctionne avec tous les logiciels compatibles avec WEEX, y compris ceux qui ne sont pas des courtiers, et vous donne un contrôle total sur les autorisations et la restriction par adresse IP.

Créer une clé API WEEX étape par étape

1. Connectez-vous à WEEX sur le site web. Allez dans « Compte », puis « Gestion des API », et sélectionnez « Créer une clé API ». La page API WEEX comporte un bouton « Créer une API » qui ouvre le même écran.
2. Nommez la clé en fonction de la plateforme à laquelle elle est destinée.
3. Choisissez une phrase secrète composée uniquement de lettres et de chiffres. La FAQ de WEEX précise que les caractères spéciaux ne sont pas acceptés. La phrase secrète ne peut ni être récupérée ni modifiée par la suite.
4. Choisissez les autorisations. Les nouvelles clés sont configurées par défaut en lecture seule. Ajoutez Spot ou Futures uniquement si la plateforme doit passer des ordres sur ce marché. Les deux autorisations de trading sont indépendantes : un bot de contrats à terme n’a donc pas besoin d’accéder au marché spot.
5. Associez des adresses IP si la plateforme publie les adresses depuis lesquelles elle se connecte.
6. Effectuez la vérification de sécurité.
7. Copiez la clé API, la clé secrète et la phrase secrète, puis conservez-les dans un endroit sûr. Les guides de configuration de HaasOnline et de KoinX précisent tous deux que la clé secrète ne s’affiche qu’une seule fois.

Trois limites sont à connaître. Chaque compte peut créer jusqu’à 10 groupes de clés API, selon le guide de préparation à l’intégration de WEEX. Il faut environ 15 minutes pour qu’une nouvelle clé ou une clé modifiée soit activée partout. Enfin, le guide de KoinX indique que WEEX peut demander un questionnaire d’activation API et envoyer un e-mail de confirmation avant qu’une clé fonctionne. Une clé qui ne marche pas dans les premières heures n’est donc pas nécessairement mal configurée.

Associer la clé et passer une première commande

Les plateformes désignent différemment les trois valeurs. HaasOnline, qui a ajouté WEEX le 22 août 2026, en est un exemple classique : ouvrez « Exchange Accounts », choisissez WEEX spot ou futures, saisissez la clé API comme clé publique et la clé secrète comme clé privée, ajoutez la phrase secrète, puis cliquez sur le bouton de test de la clé. « Access key » et « public key » désignent toutes deux la clé API.

Avant de laisser une stratégie s’exécuter, passez manuellement une commande par l’intermédiaire de la plateforme :

1. Choisissez une paire liquide et saisissez la plus petite quantité autorisée par la plateforme, sous la forme d’un ordre à cours limité placé loin du cours actuel.
2. Vérifiez que l’ordre apparaît bien dans vos ordres ouverts sur WEEX.
3. Annulez-le depuis la plateforme et vérifiez qu’il disparaît de WEEX.

Ce test aller-retour confirme que la clé, l’autorisation et la correspondance de la paire fonctionnent, et il ne coûte rien.

En cas d’échec, l’une des causes suivantes est généralement en cause :

• Erreur -1052, autorisations insuffisantes. La clé ne dispose pas de l’autorisation Futures, ou la paire n’est pas prise en charge.
• Erreurs d’autorisation sur une clé toute neuve. Attendez 15 minutes.
• HTTP 429. La plateforme envoie trop de requêtes. La limite REST de WEEX est de 500 unités de poids toutes les 10 secondes par adresse IP.
• Erreurs de signature ou de phrase secrète. Un des trois éléments a été collé avec un caractère manquant ou un espace en trop.
• Requêtes rejetées lorsque la restriction IP est activée. La plateforme se connecte depuis une adresse qui ne figure pas dans votre liste.

La FAQ de l’API Futures de WEEX répertorie tous les codes.

Sécurité des clés API WEEX : six paramètres pour limiter les dégâts

Une clé de trading ne peut pas retirer de fonds, mais elle peut tout de même entraîner des pertes. Sur toutes les plateformes d’échange, un abus connu consiste pour un attaquant à utiliser une clé volée limitée au trading afin d’acheter un jeton peu liquide à un prix gonflé auprès d’un compte qu’il contrôle. Ces six bonnes pratiques permettent de réduire ce risque.

1. Accordez le minimum d’autorisations nécessaire. Les outils fiscaux et de gestion de portefeuille ont besoin d’un accès en lecture seule. KoinX ne demande rien de plus. Une clé en lecture seule ne peut pas passer d’ordre.
2. Associez des adresses IP dès que la plateforme le permet. La documentation de WEEX indique que les clés sans restriction IP « présentent des risques de sécurité ». Certains services ne fonctionnent pas avec une liste fixe. KoinX conseille aux utilisateurs de laisser la restriction IP désactivée. Si une plateforme a besoin d’une clé sans restriction, gardez cette clé en lecture seule.
3. Utilisez une clé par plateforme. Avec jusqu’à 10 groupes de clés, rien ne justifie de les partager. Une clé distincte permet de désactiver un service sans interrompre les autres et de savoir laquelle a été divulguée.
4. Considérez la phrase secrète comme un troisième secret. Ne l’incluez pas dans des captures d’écran, des messages de discussion ou des demandes d’assistance. Les consignes de WEEX sont sans ambiguïté : « Ne partagez jamais votre phrase secrète. »
5. Refusez toute demande d’autorisations allant au-delà du trading. Les guides d’intégration indiquent que les autorisations des clés que vous créez sont Lecture seule, Spot et Futures. Une plateforme qui vous demande votre mot de passe de connexion WEEX ou un accès aux retraits réclame des informations dont elle n’a pas besoin pour effectuer des opérations de trading.
6. En cas de doute, supprimez la clé. WEEX recommande de supprimer immédiatement toute clé compromise. Faites de même pour toute plateforme que vous n’utilisez plus.

Déconnecter une plateforme de WEEX

Supprimez la clé de la plateforme, puis effacez-la dans la section Gestion des API de WEEX. C’est cette deuxième étape qui compte : une clé supprimée uniquement des paramètres de la plateforme reste utilisable par quiconque en détient une copie.

La même règle s’applique aux clés créées avec Fast Connect. Le guide OAuth de WEEX indique que la clé existante doit être supprimée avant de pouvoir relier de nouveau le compte à cette plateforme.

Connecter une plateforme à WEEX ne prend que quelques minutes. Les choix faits pendant ce laps de temps déterminent le niveau de risque tant que la clé existe : les autorisations accordées, les adresses IP autorisées et le fait de supprimer ou non la clé lorsqu’elle n’est plus utilisée. Les clés se créent et se gèrent depuis la page API de WEEX.

FAQ

1. Combien de clés API puis-je créer sur WEEX ?

Jusqu’à 10 groupes de clés API par compte, selon le guide de préparation à l’intégration de WEEX. C’est suffisant pour attribuer une clé propre à chaque plateforme connectée et révoquer l’accès d’un service sans affecter les autres.

2. Puis-je réinitialiser une phrase secrète API WEEX perdue ?

Non. La documentation de WEEX indique qu’une phrase secrète perdue ne peut être ni récupérée ni modifiée. Supprimez la clé, créez-en une nouvelle avec une nouvelle phrase secrète et mettez à jour la plateforme qui l’utilisait.

3. Pourquoi ma nouvelle clé API WEEX renvoie-t-elle une erreur d’autorisation ?

Les trois causes habituelles sont une autorisation de trading manquante, une paire non couverte par le marché de la clé et un délai d’activation. WEEX indique qu’il faut environ 15 minutes pour activer les clés nouvelles ou modifiées. Réessayez donc après ce délai avant de modifier les paramètres.

4. WEEX prend-il en charge les connexions TradingView ou FIX ?

La FAQ de l’API Futures de WEEX indique que l’intégration TradingView et l’API FIX ne sont pas prises en charge. Les connexions passent par les interfaces REST et WebSocket, directement ou par l’intermédiaire d’une plateforme qui les a intégrées.