Flux privés de l'API WebSocket v1 - openOrders

Dernière mise à jour : 1 avr. 2025

Le flux openOrders de l'API WebSocket v1 est un flux privé de gestion de compte qui fournit un statut en temps réel de toutes les commandes ouvertes associées à votre compte Kraken.

Toute modification du statut d'un ordre, telle qu'un nouvel ordre placé, un ordre partiellement ou entièrement exécuté ou un ordre annulé, entraînera l'envoi d'un message de mise à jour via le flux openOrders.

Comment s'abonner

Une fois qu'une connexion à l'API WebSocket v1 a été établie, le flux openOrders peut être souscrit en récupérant un jeton d'authentification via le point de terminaison GetWebSocketsToken de l'API REST, puis en envoyant un message d'abonnement comme suit :

  • {"event":"subscribe", "subscription":{"name":"openOrders", "token":"WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f"}}

Exemple de flux

Voici un exemple du flux openOrders, illustrant le type de messages reçus pour diverses modifications du statut des ordres :

{"connectionID":14950811667203285981,"event":"systemStatus","status":"online","version":"0.3.0"}{"channelName":"openOrders","event":"subscriptionStatus","status":"subscribed","subscription":{"name":"openOrders"}}[[], "openOrders"]{"event":"heartbeat"}{"event":"heartbeat"}[[{"OH6WIE-OYECX-FIIN3H":{"avg_price":"0.00000","cost":"0.00000","descr":{"close":"","leverage":"5:1","order":"buy 0.00200000 ETH/USD @ limit 100.00000 with 5:1 leverage","ordertype":"limit","pair":"ETH/USD","price":"100.00000","price2":"0.00000","type":"buy"},"expiretm":"1570445592","fee":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq","opentm":"1570445562.883878","refid":null,"starttm":null,"status":"pending","stopprice":"0.00000","userref":0,"vol":"0.00200000","vol_exec":"0.00000000"}}],"openOrders"][[{"OH6WIE-OYECX-FIIN3H":{"status":"open"}}],"openOrders"]{"event":"heartbeat"}{"event":"heartbeat"}[[{"OH6WIE-OYECX-FIIN3H":{"status":"canceled"}}],"openOrders"]{"event":"heartbeat"}{"event":"heartbeat"}

Lors de l'abonnement au flux openOrders, un message de statut d'abonnement est reçu :

  • {"channelName":"openOrders","event":"subscriptionStatus","status":"subscribed","subscription":{"name":"openOrders"}}

suivi d'un instantané vide qui indique que le compte n'a pas d'ordres ouverts actuellement :

  • [[], "openOrders"]

Lorsqu'un nouvel ordre est placé, un message initial est reçu fournissant les détails de l'ordre, immédiatement suivi d'un message indiquant un changement de statut de en attente à ouvert :

  • [[{"OH6WIE-OYECX-FIIN3H":{"avg_price":"0.00000","cost":"0.00000","descr":{"close":"","leverage":"5:1","order":"buy 0.00200000 ETH/USD @ limit 100.00000 with 5:1 leverage","ordertype":"limit","pair":"ETH/USD","price":"100.00000","price2":"0.00000","type":"buy"},"expiretm":"1570445592","fee":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq","opentm":"1570445562.883878","refid":null,"starttm":null,"status":"pending","stopprice":"0.00000","userref":0,"vol":"0.00200000","vol_exec":"0.00000000"}}],"openOrders"]

  • [[{"OH6WIE-OYECX-FIIN3H":{"status":"open"}}],"openOrders"]

Quelques secondes plus tard, l'ordre est annulé (avant d'avoir été exécuté/rempli), ce qui entraîne un message d'annulation d'ordre avec un changement de statut de ouvert à annulé :

  • [[{"OH6WIE-OYECX-FIIN3H":{"status":"canceled"}}],"openOrders"]

Les séparateurs décimaux et de milliers affichés dans cet article peuvent différer des formats affichés sur nos plateformes de trading. Consultez notre article sur la façon dont nous utilisons les points et les virgules pour plus d'informations.

Besoin d’aide supplémentaire ?