Comment retrouver vos commandes ouvertes et les annuler rapidement sur OKX ?

Accès aux commandes ouvertes via l'API OKX REST

1. Utilisez le point de terminaison GET /api/v5/trade/orders-ending pour récupérer tous les ordres actuellement actifs pour un instrument spécifique ou sur tous les instruments.

2. L'authentification nécessite des en-têtes OK-ACCESS-KEY , OK-ACCESS-SIGN , OK-ACCESS-TIMESTAMP et OK-ACCESS-PASSPHRASE valides.

3. La demande doit inclure un horodatage ISO 8601 précis avec une précision de la milliseconde, synchronisé à ± 30 secondes de l'heure du serveur OKX.

4. Des paramètres tels que instId , ordType et limit permettent de filtrer les résultats pour réduire la taille de la charge utile et améliorer la vitesse de réponse.

5. La réponse contient l'ID de commande ( ordId ), le statut ( state ), le côté ( side ), la taille ( sz ), le prix ( px ) et l'heure de création ( ts ), tous essentiels pour une identification et une action précises.

Annulation de commandes à l'aide de l'API Trade

1. Lancez l'annulation en appelant POST /api/v5/trade/cancel-order avec le ordId cible et l'instId correspondant.

2. Plusieurs commandes peuvent être annulées en une seule demande par lots à l'aide de POST /api/v5/trade/cancel-batch-orders , prenant en charge jusqu'à 20 commandes par appel.

3. Chaque tentative d'annulation renvoie un champ de code et de message : des valeurs telles que 0 et succès indiquent une résiliation réussie.

4. Si une commande a déjà été exécutée ou annulée, l'API renvoie le code : 51000 avec le message Order not exist , ne nécessitant aucune autre action.

5. Les annulations ayant échoué en raison d'un délai d'attente du réseau ou d'une limitation du débit doivent être réessayées avec une logique d'attente exponentielle intégrée dans le code de production.

Surveillance en temps réel via le canal privé WebSocket

1. Établissez une connexion WebSocket persistante à wss://ws.okx.com:8443/ws/v5/private à l'aide d'informations d'identification valides.

2. Abonnez-vous au canal privé des commandes avec des paramètres spécifiant instType (par exemple, SPOT , SWAP ) et des filtres instId facultatifs.

3. Chaque changement d'état de commande ( en direct , partiellement rempli , rempli , annulé , en attente d'annulation ) est appliqué instantanément sans surcharge d'interrogation.

4. Les messages entrants contiennent ordId , state , fillSz , avgPx et clOrdId , permettant une réconciliation locale immédiate.

5. Un mécanisme de battement de cœur doit être implémenté côté client pour maintenir la stabilité de la connexion ; les pings manquants déclenchent une logique de reconnexion automatique.

Automatisation avec la bibliothèque python-okx

1. Instanciez TradeAPI avec l'indicateur réel ou démo défini sur « 0 » pour le trading en direct ou sur « 1 » pour la simulation.

2. Appelez la méthode get_orders_ending() pour récupérer les commandes en attente, renvoyant une liste de dictionnaires avec les métadonnées complètes de la commande.

3. Parcourez les résultats et invoquez Cancel_order(instId=..., ordId=...) pour chaque commande ciblée.

4. Gérez les exceptions telles que OkxAPIException lorsque des paramètres non valides ou des signatures expirées provoquent des échecs.

5. Enregistrez chaque tentative d'annulation, y compris les horodatages, l'ordId et les codes de réponse, pour prendre en charge l'auditabilité et le débogage.

Foire aux questions

Q1 : Puis-je annuler toutes les commandes ouvertes en même temps ? Oui. Utilisez POST /api/v5/trade/cancel-all-orders avec instId et instType facultatifs pour mettre fin aux ordres correspondants globalement ou par instrument.

Q2 : Pourquoi ma demande d'annulation renvoie-t-elle « Commande introuvable » même si elle apparaît dans la liste en attente ? Cela se produit lorsque la commande devient exécutée ou annulée entre le moment où vous l'avez récupérée et celui où vous avez émis la commande d'annulation, une condition de concurrence atténuée par la vérification de l'état avant d'envoyer l'annulation.

Q3 : Existe-t-il un moyen d’empêcher l’annulation accidentelle de commandes de grande valeur ? Implémentez des règles de validation avant annulation dans votre script, telles que des vérifications de la longueur minimale de l'ordId , la liste blanche des valeurs instId autorisées ou l'exigence d'une confirmation manuelle pour les commandes dépassant un seuil de taille défini.

Q4 : Les commandes annulées apparaissent-elles dans l’historique des transactions ? Non. Les commandes annulées sont exclues des réponses /api/v5/trade/fills . Ils restent visibles uniquement dans les commandes en attente jusqu'à leur annulation, puis disparaissent de tous les points de terminaison publics à moins qu'ils ne soient récupérés via /api/v5/trade/orders-history avec une plage de temps et des filtres d'état appropriés.