Фід openOrders у WebSocket API v1 — це приватний фід для керування акаунтом, який надає статус усіх відкритих ордерів, пов'язаних із вашим акаунтом Kraken, у режимі реального часу.
Будь-які зміни статусу ордера, як-от розміщення нового ордера, часткове або повне виконання ордера або скасування ордера, призведуть до надсилання повідомлення про оновлення через фід openOrders.
Після встановлення з'єднання з WebSocket API v1 на фід openOrders можна підписатися, отримавши токен автентифікації через ендпоїнт GetWebSocketsToken у REST API, а потім надіславши повідомлення про підписку, подібне до наступного:
{"event":"subscribe", "subscription":{"name":"openOrders", "token":"WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f"}}
Нижче наведено приклад фіду openOrders, що ілюструє типи повідомлень, які отримуються при різних змінах статусу ордера:
{"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"}
Після підписки на фід openOrders отримується повідомлення про статус підписки:
{"channelName":"openOrders","event":"subscriptionStatus","status":"subscribed","subscription":{"name":"openOrders"}}
після чого йде порожній знімок (snapshot), який вказує на те, що в акаунті наразі немає відкритих ордерів:
[[], "openOrders"]
При розміщенні нового ордера отримується початкове повідомлення з деталями ордера, за яким відразу йде повідомлення про зміну статусу з pending на open:
[[{"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"]
Через кілька секунд ордер скасовується (до того, як він був виконаний), що призводить до повідомлення про скасування ордера зі зміною статусу з open на canceled:
[[{"OH6WIE-OYECX-FIIN3H":{"status":"canceled"}}],"openOrders"]
Десяткові розділювачі та розділювачі тисяч, наведені в цій статті, можуть відрізнятися від форматів, що відображаються на наших торгових платформах. Ознайомтеся з нашою статтею про те, як ми використовуємо крапки та коми, щоб дізнатися більше.