Comment passer un ordre au marché sur OKX ?

Bases des ordres au marché sur OKX

1. Un ordre au marché est exécuté immédiatement au meilleur prix disponible dans le carnet d’ordres, en privilégiant la rapidité plutôt que le contrôle des prix.

2. Contrairement aux ordres à cours limité, les ordres au marché ne nécessitent pas de spécification de prix : seuls l'identifiant et la taille de l'instrument sont obligatoires.

3. Les ordres de marché sont sujets à des dérapages, notamment en période de faible liquidité ou de forte volatilité.

4. OKX impose des exigences de taille minimale par paire de trading, qui varient selon l'actif et doivent être respectées pour éviter le rejet.

5. Le paramètre tdMode doit être explicitement défini sur « cash » pour les ordres de marché au comptant, ce qui le distingue des modes sur marge ou sur produits dérivés.

Paramètres requis pour l'exécution

1. instId identifie la paire de trading, telle que « BTC-USDT » , et doit correspondre à la convention de dénomination officielle des instruments d'OKX.

2. le côté définit la direction : « acheter » ou « vendre » , avec le respect de la casse appliqué par l'API.

3. ordType doit être défini sur 'market' ; tout écart déclenche une OkxParamsException .

4. sz désigne la quantité dans la devise de base (par exemple, BTC) et doit être transmis sous forme de chaîne décimale (et non de flottant) pour préserver la précision.

5. api_key , secret_key et la phrase secrète doivent être correctement chargées à partir de variables d'environnement ou de sources de configuration sécurisées.

Flux de signature et d'authentification

1. Chaque requête REST privée nécessite une signature HMAC-SHA256 horodatée à l'aide de la clé secrète et d'une chaîne de message canonique.

2. Le format du message est strictement méthode + chemin + horodatage + corps , où le corps est vide pour les requêtes GET mais inclut la charge utile JSON pour les POST.

3. Les en-têtes doivent inclure OK-ACCESS-KEY , OK-ACCESS-SIGN , OK-ACCESS-TIMESTAMP et OK-ACCESS-PASSPHRASE .

4. Les horodatages doivent être au format ISO 8601 UTC avec une précision à la milliseconde, par exemple '2026-09-08T14:21:33.123Z' .

5. L'échec de la synchronisation de l'heure du système dans un délai de ± 30 secondes des serveurs NTP entraîne des erreurs d'authentification 50113 .

Implémentation Python à l'aide de python-okx

1. Installez la bibliothèque via pip install python-okx et vérifiez la compatibilité des versions avec Python 3.7+.

2. Importez TradeAPI et initialisez-le avec les informations d'identification et l'indicateur (0 pour la production, 1 pour la démo).

3. Utilisez place_order() avec ordType='market' et assurez-vous que sz est un Decimal('0.01') — et non 0.01 .

4. Gérez les exceptions telles que OkxParamsException et OkxRequestException pour faire la distinction entre les erreurs de saisie et les pannes de réseau.

5. Confirmez l'exécution en inspectant les champs ordId et state de la réponse, où « rempli » indique une exécution complète.

Foire aux questions

Q : Puis-je passer un ordre au marché sans activer les autorisations de trading sur ma clé API ? R : Non. L'autorisation de trading doit être explicitement activée lors de la création de la clé API ; sinon, la requête renvoie le code d'erreur 50006 .

Q : Pourquoi mon ordre au marché échoue-t-il avec un « Solde insuffisant » même lorsque les fonds semblent disponibles ? R : OKX vérifie à la foisavailBal et congeléBal avant l'exécution. Les fonds bloqués dans des ordres en attente ou des positions sur marge sont exclus du solde disponible.

Q : Y a-t-il une différence entre les ordres au comptant et les ordres à terme ? R : Oui. Les ordres du marché à terme nécessitent tdMode='isolated' ou 'cross' , et sz fait référence à la quantité du contrat (et non à l'actif de base) en ajoutant une validation spécifique à la couche.

Q : Que se passe-t-il si j'omets la phrase secrète dans l'en-tête de la demande ? R : L'API rejette la demande avec le statut 401 et le code d'erreur 50112 , indiquant une phrase secrète manquante ou invalide.