Den WebSocket API v1 openOrders-flödet är ett privat flöde för kontohantering som ger en realtidsstatus för alla öppna ordrar som är kopplade till ditt Kraken-konto.
Alla ändringar i en orders status, såsom att en ny order läggs, en order delvis eller helt fylls, eller en order annulleras, kommer att resultera i att ett uppdateringsmeddelande skickas via openOrders-flödet.
När en anslutning till WebSocket API v1 har upprättats, kan openOrders-flödet prenumereras på genom att hämta en autentiseringstoken via REST API GetWebSocketsToken-slutpunkten, och sedan skicka ett prenumerationsmeddelande som följande:
{"event":"subscribe", "subscription":{"name":"openOrders", "token":"WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f"}}
Följande är ett exempel på openOrders-flödet, som illustrerar vilken typ av meddelanden som tas emot för olika orderstatusändringar:
{"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"}
När du prenumererar på openOrders-flödet tas ett prenumerationsstatusmeddelande emot:
{"channelName":"openOrders","event":"subscriptionStatus","status":"subscribed","subscription":{"name":"openOrders"}}
följt av en tom ögonblicksbild som indikerar att kontot inte har några för närvarande öppna ordrar:
[[], "openOrders"]
När en ny order läggs tas ett initialt meddelande emot som tillhandahåller orderns detaljer, omedelbart följt av ett meddelande som indikerar en statusändring från väntande till öppen:
[[{"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"]
Några sekunder senare annulleras ordern (innan den har utförts/fyllts), vilket orsakar ett orderannulleringsmeddelande med en statusändring från öppen till annullerad:
[[{"OH6WIE-OYECX-FIIN3H":{"status":"canceled"}}],"openOrders"]
Decimal- och tusentalsavgränsarna som visas i den här artikeln kan skilja sig från de format som visas på våra handelsplattformar. Läs vår artikel om hur vi använder punkter och kommatecken för mer information.