Comment corriger l'erreur de rejet d'une commande à terme OKX ?

Comprendre les déclencheurs de rejet de commande

1. Un solde de marge insuffisant déclenche un rejet immédiat avant l’acheminement des commandes.

2. Un ID d'instrument non valide provoque une erreur 51008 avec le message « Instrument not found ».

3. Un écart de prix au-delà de la tolérance de glissement autorisée entraîne un rejet silencieux sans code explicite.

4. Le paramètre d'effet de levier dépassant les plafonds au niveau de la position ou du compte entraîne une réponse d'erreur 50007.

5. La taille de la commande ne respectant pas les exigences notionnelles minimales pour le contrat spécifique génère une erreur 51009.

Échecs d’authentification et de validation de signature

1. Une différence d'horodatage supérieure à ± 30 secondes par rapport à l'heure du serveur OKX produit une erreur de signature 10002.

2. L'en-tête OK-ACCESS-PASSPHRASE manquant ou mal formé renvoie le statut 401 non autorisé.

3. Un résumé HMAC-SHA256 incorrect en raison d'un mauvais codage de clé secrète (par exemple, base64 par rapport aux octets bruts) donne systématiquement 10 002.

4. Le corps de la requête non codé en UTF-8 corrompt la génération de signature, conduisant à des réponses 401 intermittentes.

5. L'horodatage réutilisé sur plusieurs requêtes entraîne une détection et un rejet occasionnels de collision.

Contraintes de paramètres spécifiques au contrat

1. BTC-USDT-SWAP nécessite une précision de prix de 0,1 ; la soumission de 42100.005 déclenche OkxParamsException.

2. ETH-USD-0627 expire à 08h00 UTC ; les commandes passées après expiration renvoient le 51012 avec « Date de livraison invalide ».

3. Les positions négatives sur les contrats perpétuels inverses nécessitent un basculement de mode de position valide via /api/v5/account/set-position-mode.

4. Les comptes sur marge multidevises doivent spécifier explicitement le paramètre ccy ; l'omission donne 51008.

5. Les ordres stop sur les contrats sur marge USDC imposent un alignement triggerPx et ordPx dans la bande de 1 %, sinon ils sont rejetés.

Comportement de limitation de débit et de limitation

1. Par défaut, 20 requêtes/s par clé API s'appliquent globalement à tous les points de terminaison, y compris /api/v5/trade/order.

2. Les pics de rafales dépassant 100 requêtes en 5 secondes activent une limitation temporaire au niveau IP pendant 60 secondes.

3. Les soumissions de commandes simultanées utilisant le même ordId provoquent un conflit d'idempotence et une erreur 51008.

4. L'abonnement WebSocket limite le plafond à 100 canaux actifs par connexion ; le dépassement déclenche une déconnexion automatique.

5. Les requêtes de commandes historiques avec une limite = 1 000 dépassent le budget tarifaire et renvoient 429 avec l'en-tête Retry-After défini sur 2.

Foire aux questions

Q : Pourquoi mon ordre au marché est-il rejeté avec le code 51008 même lorsque le solde semble suffisant ? R : Le système valide la marge disponible après déduction des frais estimés et du tampon de liquidation potentiel, et pas seulement du solde du portefeuille. Vérifiez le champavailEq de la réponse /api/v5/account/balance pour connaître les capitaux propres utilisables.

Q : Puis-je soumettre un ordre à prix nul sur un swap perpétuel ? R : Non. Les valeurs de prix nulles ou nulles violent la validation du protocole. Les ordres de marché nécessitent d’omettre entièrement le prix ; les ordres limités doivent fournir une valeur numérique non nulle alignée sur la taille du tick.

Q : OKX rejette-t-il les commandes si l'horloge système du client dérive de 15 secondes ? R : Oui. OKX applique une synchronisation stricte de l'horodatage. Une dérive supérieure à ± 15 secondes peut entraîner un comportement incohérent : certaines requêtes réussissent, d'autres échouent avec 10002. Synchronisez-vous toujours avec NTP avant de négocier.

Q : Que se passe-t-il lorsque vous passez deux commandes identiques avec le même ordId dans un délai de 100 ms ? R : La deuxième demande est rejetée avec 51008 et le message « ID de commande en double détecté ». L'idempotence ne fonctionne que pour les tentatives dans les 30 secondes en utilisant une charge utile et un horodatage identiques.