Codes d'erreur de l'API WEEX décodés : Corrigez rapidement de 40001 à 43011
La plupart des erreurs de l'API WEEX ne correspondent pas à ce que dit le message. Une erreur 40009 API validation failed ne signifie presque jamais que votre clé est mauvaise — elle indique généralement que votre chaîne de signature a été assemblée dans le mauvais ordre. Une erreur 40102 Trading pair configuration does not exist sur une paire qui existe pourtant signifie généralement que vous avez envoyé un symbole de futures au domaine spot. Lire le code littéralement est ce qui transforme une correction de dix minutes en une après-midi de travail.
Ceci est une référence de travail pour les codes d'erreur de l'API WEEX qu'une intégration réelle rencontre, regroupés par la couche qui a échoué plutôt que par numéro. Chaque code ci-dessous provient de la liste des codes d'erreur de l'API WEEX telle que publiée le 27 juillet 2026 ; les règles de signature, de timing et de limitation de débit proviennent de la documentation de l'API spot WEEX à la même date. Les deux changent, alors vérifiez à nouveau avant de déployer.

Une clarification d'abord, car les résultats de recherche les mélangent : cet article concerne l'API de l'échange de cryptomonnaies WEEX (api-spot.weex.com et api-contract.weex.com). Cela n'a rien à voir avec Apache Weex, le framework d'interface utilisateur mobile retiré d'Alibaba qui partage le nom et renvoie des erreurs comme -1001. Si vos traces de pile mentionnent WXSDKInstance, vous êtes dans le mauvais manuel.
Comment les codes d'erreur de l'API WEEX sont regroupés
La liste officielle est un tableau plat. En pratique, les codes tombent dans sept couches de diagnostic, et connaître la couche vous indique quel fichier ouvrir. Ce regroupement est le moyen le plus rapide de réduire le temps de débogage, car les couches 1 à 4 concernent votre client et la couche 7 n'est pas du tout votre bug.
| Couche | Codes | Ce qui a réellement échoué | Ouvrir ceci en premier |
|---|---|---|---|
| 1. Présence de l'en-tête | 40001, 40002, 40003, 40011 | Un en-tête requis n'a jamais quitté votre client | Configuration de votre client HTTP |
| 2. Validité des identifiants | 40006, 40009, 40012, 40016 | Clé, phrase secrète ou état 2FA incorrect | Page de gestion de l'API |
| 3. Signature et temps | 40005, 40007, 40008 | Chaîne de pré-hachage, horloge ou Content-Type | Votre fonction de signature |
| 4. Compte et accès | 40013, 40014, 40018 | Compte gelé, portée manquante, IP non autorisée | Permissions de la clé |
| 5. Forme de la requête | 40102, 40305, 40409, 40704, 40707, 40724, 40912, 40913, 41101 | Les paramètres ou le symbole ne correspondent pas au point de terminaison | Spécifications du point de terminaison |
| 6. Moteur d'ordres | 42002, 43001–43011 | Le solde ou les limites de produit ont rejeté l'ordre | Limites de produit et solde |
| 7. Plateforme et limitation | 429, 40015, 40200, 40725 | Côté serveur ; réessayez, ne réécrivez pas | Logique de backoff |
La règle pratique : si le code commence par 400, suspectez votre requête. S'il commence par 43, suspectez vos paramètres d'ordre. S'il s'agit de 429, 40200 ou 40015, ne suspectez rien et attendez.
Erreurs d'authentification de l'API WEEX : 40001 à 40018
Cette bande produit le plus grand nombre de tickets de support et le moins de problèmes d'identifiants réels. Six de ces codes sont résolus en corrigeant la façon dont les en-têtes sont construits, et non en générant une nouvelle clé.
| Code | Message | Cause réelle | Correction |
|---|---|---|---|
| 40001 | The request header 'ACCESS_KEY' cannot be empty | En-tête supprimé par un proxy ou une bibliothèque client qui met en minuscules et supprime les en-têtes inconnus | Enregistrez les en-têtes sortants, pas ceux que vous avez définis |
| 40002 | The request header 'ACCESS_SIGN' cannot be empty | Signature calculée après que l'objet de requête a été figé | Signez avant l'envoi |
| 40003 | The request header 'ACCESS_TIMESTAMP' cannot be empty | Horodatage généré mais jamais joint | Joignez la même valeur que celle avec laquelle vous avez signé |
| 40005 | Invalid ACCESS_TIMESTAMP | Secondes au lieu de millisecondes, ou chaîne ISO | Envoyez un horodatage en millisecondes à 13 chiffres |
| 40006 | Invalid ACCESS_KEY | Format de clé incorrect | Les clés API WEEX commencent par WEEX — vérifiez que vous n'avez pas collé le secret |
| 40007 | Invalid Content_Type, please use 'application/json' | Le client a utilisé application/x-www-form-urlencoded par défaut | Définissez application/json explicitement sur POST |
| 40008 | Request timestamp has expired | Requête plus ancienne que la fenêtre de validité de 30 secondes | Voir la section suivante — c'est un bug différent du 40005 |
| 40009 | API validation failed | Incohérence de signature, généralement l'ordre du pré-hachage | Reconstruisez la chaîne de pré-hachage exactement |
| 40011 | The request header 'ACCESS_PASSPHRASE' cannot be empty | Phrase secrète omise car la documentation la liste en dernier | Incluez-la dans chaque appel privé |
| 40012 | Incorrect API key/passphrase | Erreur de frappe dans la phrase secrète, ou clé d'un sous-compte différent | Regénérez et saisissez à nouveau les deux |
| 40013 | User account is frozen | Suspension au niveau du compte | Soumettez un ticket de support |
| 40014 | Insufficient permissions | La portée de la clé exclut le trading ou les retraits | Réémettez la clé avec la bonne portée |
| 40016 | Users must bind a mobile phone or Google Authenticator | Accès API bloqué jusqu'à ce que la 2FA soit configurée | Activez Google Authenticator |
| 40018 | Illegal IP request | L'IP appelante est en dehors de la liste blanche | Voir la section domaine de base et IP ci-dessous |
Deux détails méritent d'être assimilés. Les règles de construction de signature de WEEX définissent la chaîne de pré-hachage comme timestamp + method.toUpperCase() + requestPath + "?" + queryString + body, HMAC-SHA256 avec votre clé secrète, puis Base64. Le ? et la chaîne de requête sont omis lorsqu'il n'y a pas de requête. Trois choses cassent cela en production : get en minuscules, un chemin de requête qui inclut l'hôte, et un corps JSON que votre bibliothèque HTTP re-sérialise après que vous l'avez signé — l'ordre des clés change, les octets changent, et vous obtenez 40009.
Le deuxième détail est un piège de nommage. Le texte d'erreur cite les noms d'en-tête avec des traits de soulignement (ACCESS_KEY, ACCESS_SIGN, ACCESS_TIMESTAMP, ACCESS_PASSPHRASE), tandis que la documentation de signature les écrit avec des traits d'union (ACCESS-SIGN, ACCESS-TIMESTAMP). Copiez la forme utilisée dans la documentation du point de terminaison avec laquelle vous vous intégrez et enregistrez les en-têtes bruts sur votre premier appel réussi, plutôt que de faire confiance à la chaîne d'erreur ou à un extrait de blog.
40005 vs 40008 : deux bugs d'horodatage différents
Ces deux-là sont constamment confondus, et la mauvaise correction fait perdre le plus de temps.
40005 Invalid ACCESS_TIMESTAMP est un problème de format. La valeur n'est pas une époque en millisecondes à 13 chiffres — souvent une époque en secondes à 10 chiffres de time.time() en Python ou time() en PHP, ou une chaîne ISO-8601. Cela échoue instantanément et systématiquement, à chaque requête, y compris la première.
40008 Request timestamp has expired est un problème d'horloge ou de latence. Le format est correct, mais la valeur est à plus de 30 secondes de l'heure du serveur WEEX. Les requêtes ne sont valides que pendant 30 secondes, et la signature est rejetée si l'horodatage s'écarte de plus de 30 secondes de l'horloge du serveur API dans les deux sens — une machine qui avance échoue tout autant qu'une machine qui retarde.
| Symptôme | Code probable | Cause profonde | Correction |
|---|---|---|---|
| Échoue sur 100% des requêtes dès le premier appel | 40005 | Unité ou type incorrect | Multipliez les secondes par 1000, envoyez en tant qu'entier |
| Fonctionnait en dev, échoue dans un conteneur ou VM | 40008 | Dérive de l'horloge hôte, pas de NTP dans l'image | Synchronisez avec NTP, ou interrogez le point de terminaison de l'heure du serveur public et mettez en cache le décalage |
| Échoue uniquement sous charge ou lors de tentatives | 40008 | Horodatage généré une fois, réutilisé dans une file d'attente | Re-signez à chaque tentative, ne rejouez jamais une requête signée |
| Échoue uniquement pour les tâches par lots longue durée | 40008 | Horodatage créé au début de la tâche, requête envoyée des minutes plus tard | Générez l'horodatage lors de l'envoi |
La dérive de l'horloge à l'intérieur des conteneurs est la cause la plus fréquente d'une intégration qui "fonctionnait hier". Si vous ne pouvez pas contrôler NTP sur l'hôte, interrogez le point de terminaison de l'heure du serveur au démarrage, stockez le delta, et ajoutez-le à votre horloge locale pour chaque signature.
Prix de --
Rejets d'ordres : 43001 à 43011 et 42002
Une fois l'authentification passée, les échecs se déplacent vers le moteur de correspondance. Ces codes sont peu coûteux à corriger mais coûteux à ignorer, car un bot qui réessaie un ordre rejeté dans une boucle serrée atteindra le limiteur de débit et masquera le vrai problème.
| Code | Message | Ce qu'il faut vérifier |
|---|---|---|
| 42002 | BALANCE NOT ENOUGH | Solde dans le bon type de compte — les fonds spot ne couvrent pas un ordre futures |
| 43001 | Order does not exist | ID d'ordre d'un type de compte différent, ou déjà exécuté et purgé |
| 43002 | Order placement failed | Rejet générique ; enregistrez la requête complète et vérifiez le prix et la taille par rapport aux limites de produit |
| 43004 | There are no open orders to cancel | Annulation globale déclenchée sur un carnet vide ; traitez comme bénin, pas comme une erreur |
| 43005 | Exceeds maximum order size | Plafond par ordre pour ce produit |
| 43006 | Order quantity is less than minimum trading amount | Comparez avec minTradeAmount sur le point de terminaison des produits |
| 43007 | Order quantity exceeds the maximum trading amount | Même source, borne supérieure |
| 43008 / 43011 | Current order price cannot be less than 0 | Champ de prix négatif ou non analysé |
| 43009 | Current order price exceeds the limit | Prix en dehors de la bande autorisée |
| 43010 | Trade amount cannot be less than 0 | Champ de montant négatif ou non analysé |
| 40912 | Single cancellation cannot exceed 50 | Découpez les annulations par lots en groupes de 50 |
| 40913 | Either orderId or clientId must be provided | Fournissez un identifiant ; ne rien envoyer est un bug silencieux dans le code conditionnel |
| 40305 | client_uid length should not exceed 40 characters | Coupez vos ID d'ordre client et supprimez les caractères spéciaux |
Celui qui piège les traders expérimentés est 40704 Only query data for the last three months. Le remplissage de l'historique des transactions au-delà de 90 jours ne fonctionnera pas via les points de terminaison de requête standard, donc tout travail de réconciliation doit persister les exécutions au fur et à mesure qu'elles se produisent plutôt que de supposer qu'il peut les récupérer plus tard.
Ce qui déclenche une erreur 429 sur l'API WEEX
Les règles de restriction d'accès fixent une valeur par défaut de 10 requêtes par seconde, sauf indication contraire d'un point de terminaison individuel. Le dépassement renvoie 429 Too Many Requests, que la liste d'erreurs affiche également comme "Requesting too frequently".
Trois propriétés de cette limite changent la façon dont vous devez concevoir autour d'elle :
- Les requêtes authentifiées sont comptées par clé API, les requêtes non authentifiées par IP publique. Deux bots partageant une clé partagent un budget. Deux bots sur un serveur avec des clés séparées ne le font pas — mais leur interrogation des données de marché public le fait, car cela est compté par IP.
- Un ordre par lots sur plusieurs paires compte comme une requête. La documentation donne l'exemple de 4 paires de trading × 10 ordres = 1 requête. Si vous placez une grille ou rééquilibrez un carnet, le traitement par lots n'est pas une micro-optimisation ; c'est une différence de débit de 40×.
- Les tentatives comptent. Un backoff exponentiel qui réessaie immédiatement sur
429vous maintiendra limité. Attendez avec du jitter, et abandonnez les ordres obsolètes plutôt que de les mettre en file d'attente.
Un budget pratique : réservez environ 60–70% de la limite pour le flux d'ordres, laissez le reste pour l'interrogation du solde et des positions, et déplacez tout ce que vous pouvez vers WebSocket. Le carnet d'ordres et les données de ticker via REST sont la raison la plus courante pour laquelle un bot de trading bien élevé finit par être limité en débit.
Erreurs de domaine de base et de liste blanche IP
Deux erreurs se signalent si mal qu'elles méritent leur propre section.
40102 Trading pair configuration does not exist sur une paire que vous pouvez voir trader sur le site n'est généralement pas un problème de symbole. WEEX divise REST entre https://api-spot.weex.com pour le spot et https://api-contract.weex.com pour les contrats. Un symbole futures envoyé au domaine spot se résout en une paire qui n'existe tout simplement pas sur ce domaine, et l'erreur est techniquement exacte et complètement trompeuse. Vérifiez l'hôte avant de vérifier le symbole.
40018 Illegal IP request signifie que l'IP appelante n'est pas sur la liste blanche de la clé. La partie délicate est ce qui la change sans que vous le remarquiez : un fournisseur cloud qui fait tourner une IP de sortie, un basculement de passerelle NAT, une reconnexion VPN, ou une adresse IPv6 utilisée alors que vous avez mis en liste blanche l'IPv4. Les conseils de support sont que vous pouvez créer une clé qui n'est pas liée à une adresse IP, et pour une clé de données de marché en lecture seule, c'est un compromis raisonnable. Pour une clé avec des permissions de trading ou de retrait, ce n'est pas le cas — une clé de trading non liée est un identifiant au porteur qui fonctionne de n'importe où sur Internet. Épinglez l'IP, et surveillez les changements au lieu de supprimer le contrôle.
Un contexte plus large sur la façon dont les surfaces REST et WebSocket s'assemblent est couvert dans l'explication du Wiki WEEX sur si WEEX prend en charge le trading API.
Une liste de contrôle de triage de l'API WEEX en 5 minutes
Exécutez ceci dans l'ordre avant d'ouvrir un ticket de support. Chaque étape isole une couche, et le premier échec vous indique où arrêter de chercher.
| Temps | Vérification | Condition de passage | Échoue comme |
|---|---|---|---|
| 0:00 | Appelez un point de terminaison public sur le bon domaine, non signé | HTTP 200 avec données | Erreur de connexion, ou 40102 si le domaine est faux |
| 0:30 | Affichez l'heure locale en ms à côté de l'heure du serveur | Dérive sous 5 secondes | 40005 (format) ou 40008 (dérive) |
| 1:00 | Enregistrez la chaîne de pré-hachage exacte que vous avez signée | Correspond à timestamp + METHOD + path + ?query + body octet pour octet | 40009 |
| 1:30 | Enregistrez les en-têtes sortants bruts du réseau | Les quatre en-têtes ACCESS présents, Content-Type est application/json | 40001, 40002, 40003, 40007, 40011 |
| 2:00 | Appelez un point de terminaison en lecture seule signé, ex. solde de compte | HTTP 200 | 40006, 40012, 40014, 40016, 40018 |
| 3:00 | Récupérez le point de terminaison des produits pour votre symbole | Renvoie les montants de trading min et max | 40102 |
| 4:00 | Placez le plus petit ordre légal au-dessus de minTradeAmount | Ordre accepté | 42002, 43005, 43006, 43007 |
| 4:30 | Vérifiez votre taux de requête sur la dernière minute | Moins de 10 par seconde soutenu | 429 |
Si chaque étape réussit et que les appels échouent toujours, les codes restants — 40013, 40015, 40409, 40725, 41101 — sont ceux pour lesquels le support WEEX vous demande explicitement d'ouvrir un ticket de travail. Incluez l'horodatage de la requête, le point de terminaison, et le code renvoyé ; ce trio est ce qui rend un ticket résoluble. La référence officielle complète est la liste des codes d'erreur API de WEEX.
Ce que les codes d'erreur vous disent sur votre intégration
Classez vos échecs par couche, pas par fréquence. Cent 429 sont un problème de conception de débit que vous pouvez régler en une après-midi. Un seul 40009 intermittent est un bug de signature qui abandonnera silencieusement des ordres au pire moment, et c'est celui qui vaut la peine d'être corrigé en premier. Les intégrations qui restent saines sur l'API WEEX partagent trois habitudes : elles re-signent à chaque tentative, elles ne font jamais confiance à l'horloge locale, et elles enregistrent la requête réseau plutôt que la requête qu'elles avaient l'intention d'envoyer.
Prêt à construire ? Créez et définissez la portée de vos clés sur la page API WEEX, commencez avec une clé en lecture seule sur les points de terminaison publics, et n'ajoutez les permissions de trading qu'une fois que votre liste de contrôle de triage fonctionne parfaitement de bout en bout.
FAQ
1. Que signifie l'erreur 40009 sur l'API WEEX ?
API validation failed est une incohérence de signature bien plus souvent qu'une mauvaise clé. Reconstruisez la chaîne de pré-hachage comme timestamp + METHOD + requestPath + "?" + queryString + body, confirmez que la méthode est en majuscules, et assurez-vous que votre bibliothèque HTTP ne re-sérialise pas le corps JSON après que vous l'avez signé.
2. Pourquoi ma requête API WEEX fonctionne-t-elle localement mais échoue-t-elle avec 40008 en production ?
Presque toujours une dérive de l'horloge hôte. L'horodatage signé doit être à moins de 30 secondes de l'heure du serveur WEEX, et les conteneurs fonctionnent fréquemment sans NTP. Synchronisez l'horloge hôte ou mettez en cache le décalage du point de terminaison de l'heure du serveur public au démarrage.
3. Quelle est la limite de débit de l'API WEEX ?
La valeur par défaut est de 10 requêtes par seconde, sauf indication contraire d'un point de terminaison, comptée par clé API pour les appels authentifiés et par IP publique pour les appels non authentifiés, comme documenté le 27 juillet 2026. Le dépassement renvoie 429.
4. Puis-je utiliser une clé API WEEX sans liste blanche IP ?
Oui — le support WEEX suggère de créer une clé non liée à une adresse IP lorsque 40018 Illegal IP request vous bloque. Réservez cela aux clés en lecture seule. Une clé de trading ou de retrait sans restriction IP fonctionne de n'importe où, ce qui constitue une dégradation significative de la sécurité.
5. Pourquoi reçois-je 40102 pour une paire de trading qui existe clairement ?
Vous appelez probablement le mauvais domaine de base. Les requêtes spot vont vers https://api-spot.weex.com et les requêtes de contrat vers https://api-contract.weex.com ; un symbole futures sur l'hôte spot produit exactement cette erreur.
6. L'API WEEX est-elle la même que le framework Apache Weex ?
Non. L'API d'échange WEEX est une interface de trading REST et WebSocket. Apache Weex est un framework d'interface utilisateur mobile abandonné avec des codes d'erreur non liés tels que -1001. Les résultats de recherche pour "weex api" mélangent les deux.
Avertissement sur les risques
Les actifs cryptographiques sont volatils, et les trader — manuellement ou via l'API WEEX — peut entraîner une perte partielle ou totale de vos fonds. Le trading automatisé ajoute des modes de défaillance que le trading manuel n'a pas : un code d'erreur non géré peut laisser des positions ouvertes ou dupliquées, une annulation limitée en débit peut échouer alors qu'une exécution passe, une dérive d'horloge peut rejeter silencieusement des ordres de réduction de risque, et une clé API sans restrictions IP ou limites de portée est un identifiant qu'un attaquant peut utiliser de n'importe où. Le trading de futures sur WEEX implique un effet de levier, qui amplifie à la fois les gains et les pertes et peut déclencher une liquidation plus rapidement qu'un bot ne peut réagir. Testez avec la plus petite taille d'ordre légale, utilisez des clés en lecture seule jusqu'à ce que votre gestion des erreurs soit prouvée, définissez des limites de position et de perte en dehors de votre logique de trading, et n'accordez jamais de permissions de retrait à une clé qui n'en a pas besoin. Rien ici n'est un conseil en investissement. Qu'est-ce qu'une API Futures ?
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







