Codes d'erreur de l'API WEEX décodés : Corrigez rapidement de 40001 à 43011

By: WEEX|

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.

Codes d'erreur de l'API WEEX décodés : Corrigez rapidement de 40001 à 43011

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.

CoucheCodesCe qui a réellement échouéOuvrir ceci en premier
1. Présence de l'en-tête40001, 40002, 40003, 40011Un en-tête requis n'a jamais quitté votre clientConfiguration de votre client HTTP
2. Validité des identifiants40006, 40009, 40012, 40016Clé, phrase secrète ou état 2FA incorrectPage de gestion de l'API
3. Signature et temps40005, 40007, 40008Chaîne de pré-hachage, horloge ou Content-TypeVotre fonction de signature
4. Compte et accès40013, 40014, 40018Compte gelé, portée manquante, IP non autoriséePermissions de la clé
5. Forme de la requête40102, 40305, 40409, 40704, 40707, 40724, 40912, 40913, 41101Les paramètres ou le symbole ne correspondent pas au point de terminaisonSpécifications du point de terminaison
6. Moteur d'ordres42002, 43001–43011Le solde ou les limites de produit ont rejeté l'ordreLimites de produit et solde
7. Plateforme et limitation429, 40015, 40200, 40725Côté serveur ; réessayez, ne réécrivez pasLogique 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é.

CodeMessageCause réelleCorrection
40001The request header 'ACCESS_KEY' cannot be emptyEn-tête supprimé par un proxy ou une bibliothèque client qui met en minuscules et supprime les en-têtes inconnusEnregistrez les en-têtes sortants, pas ceux que vous avez définis
40002The request header 'ACCESS_SIGN' cannot be emptySignature calculée après que l'objet de requête a été figéSignez avant l'envoi
40003The request header 'ACCESS_TIMESTAMP' cannot be emptyHorodatage généré mais jamais jointJoignez la même valeur que celle avec laquelle vous avez signé
40005Invalid ACCESS_TIMESTAMPSecondes au lieu de millisecondes, ou chaîne ISOEnvoyez un horodatage en millisecondes à 13 chiffres
40006Invalid ACCESS_KEYFormat de clé incorrectLes clés API WEEX commencent par WEEX — vérifiez que vous n'avez pas collé le secret
40007Invalid Content_Type, please use 'application/json'Le client a utilisé application/x-www-form-urlencoded par défautDéfinissez application/json explicitement sur POST
40008Request timestamp has expiredRequête plus ancienne que la fenêtre de validité de 30 secondesVoir la section suivante — c'est un bug différent du 40005
40009API validation failedIncohérence de signature, généralement l'ordre du pré-hachageReconstruisez la chaîne de pré-hachage exactement
40011The request header 'ACCESS_PASSPHRASE' cannot be emptyPhrase secrète omise car la documentation la liste en dernierIncluez-la dans chaque appel privé
40012Incorrect API key/passphraseErreur de frappe dans la phrase secrète, ou clé d'un sous-compte différentRegénérez et saisissez à nouveau les deux
40013User account is frozenSuspension au niveau du compteSoumettez un ticket de support
40014Insufficient permissionsLa portée de la clé exclut le trading ou les retraitsRéémettez la clé avec la bonne portée
40016Users must bind a mobile phone or Google AuthenticatorAccès API bloqué jusqu'à ce que la 2FA soit configuréeActivez Google Authenticator
40018Illegal IP requestL'IP appelante est en dehors de la liste blancheVoir 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ômeCode probableCause profondeCorrection
Échoue sur 100% des requêtes dès le premier appel40005Unité ou type incorrectMultipliez les secondes par 1000, envoyez en tant qu'entier
Fonctionnait en dev, échoue dans un conteneur ou VM40008Dérive de l'horloge hôte, pas de NTP dans l'imageSynchronisez 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 tentatives40008Horodatage généré une fois, réutilisé dans une file d'attenteRe-signez à chaque tentative, ne rejouez jamais une requête signée
Échoue uniquement pour les tâches par lots longue durée40008Horodatage créé au début de la tâche, requête envoyée des minutes plus tardGé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.

CodeMessageCe qu'il faut vérifier
42002BALANCE NOT ENOUGHSolde dans le bon type de compte — les fonds spot ne couvrent pas un ordre futures
43001Order does not existID d'ordre d'un type de compte différent, ou déjà exécuté et purgé
43002Order placement failedRejet générique ; enregistrez la requête complète et vérifiez le prix et la taille par rapport aux limites de produit
43004There are no open orders to cancelAnnulation globale déclenchée sur un carnet vide ; traitez comme bénin, pas comme une erreur
43005Exceeds maximum order sizePlafond par ordre pour ce produit
43006Order quantity is less than minimum trading amountComparez avec minTradeAmount sur le point de terminaison des produits
43007Order quantity exceeds the maximum trading amountMême source, borne supérieure
43008 / 43011Current order price cannot be less than 0Champ de prix négatif ou non analysé
43009Current order price exceeds the limitPrix en dehors de la bande autorisée
43010Trade amount cannot be less than 0Champ de montant négatif ou non analysé
40912Single cancellation cannot exceed 50Découpez les annulations par lots en groupes de 50
40913Either orderId or clientId must be providedFournissez un identifiant ; ne rien envoyer est un bug silencieux dans le code conditionnel
40305client_uid length should not exceed 40 charactersCoupez 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 429 vous 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.

TempsVérificationCondition de passageÉchoue comme
0:00Appelez un point de terminaison public sur le bon domaine, non signéHTTP 200 avec donnéesErreur de connexion, ou 40102 si le domaine est faux
0:30Affichez l'heure locale en ms à côté de l'heure du serveurDérive sous 5 secondes40005 (format) ou 40008 (dérive)
1:00Enregistrez la chaîne de pré-hachage exacte que vous avez signéeCorrespond à timestamp + METHOD + path + ?query + body octet pour octet40009
1:30Enregistrez les en-têtes sortants bruts du réseauLes quatre en-têtes ACCESS présents, Content-Type est application/json40001, 40002, 40003, 40007, 40011
2:00Appelez un point de terminaison en lecture seule signé, ex. solde de compteHTTP 20040006, 40012, 40014, 40016, 40018
3:00Récupérez le point de terminaison des produits pour votre symboleRenvoie les montants de trading min et max40102
4:00Placez le plus petit ordre légal au-dessus de minTradeAmountOrdre accepté42002, 43005, 43006, 43007
4:30Vérifiez votre taux de requête sur la dernière minuteMoins de 10 par seconde soutenu429

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

Cryptos populaires

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