WebSocket API v1 - Przykład kanału danych rynkowych

Ostatnia aktualizacja: 31 mar 2025

Kanały danych rynkowych WebSocket API v1 to seria publicznych (nieuwierzytelnionych) kanałów, które zapewniają strumień danych handlowych w czasie rzeczywistym (ticker, czas i sprzedaż, księga zleceń itp.) dla naszych rynków.

Jako strumienie danych rynkowych na żywo, wszelkie zmiany w danych rynkowych (takie jak aktualizacje najlepszych cen kupna/sprzedaży lub wolumenów, na przykład) spowodowałyby wysłanie wiadomości aktualizacyjnej za pośrednictwem jednego lub więcej kanałów danych rynkowych.

Jak subskrybować kanał danych rynkowych

Po nawiązaniu połączenia z WebSocket API v1 (przy użyciu publicznego adresu URL wss://ws.kraken.com/), można subskrybować kanały danych rynkowych, wysyłając wiadomość subskrypcyjną, taką jak poniżej:

  • •

    {"event":"subscribe", "subscription":{"name":"ticker"}, "pair":["BTC/USD"]}

Po otrzymaniu prawidłowego żądania subskrypcji, kanały danych rynkowych wysłałyby wiadomość potwierdzającą subskrypcję:

  • •

    {"channelID":324,"channelName":"ticker","event":"subscriptionStatus","pair":"XBT/USD","status":"subscribed","subscription":{"name":"ticker"}}

następnie początkową migawkę danych rynkowych (w zależności od danego kanału), a następnie strumień danych rynkowych w czasie rzeczywistym.

Przykład strumienia danych rynkowych na żywo

Poniżej znajduje się przykład kanału ticker, ilustrujący typ wiadomości odbieranych w przypadku różnych zmian danych rynkowych (takich jak wystąpienie transakcji powodujące zmianę najlepszego wolumenu kupna/sprzedaży):

[324,{"a":["42243.20000",3,"3.04172624"],"b":["42243.10000",0,"0.28500000"],"c":["42243.20000","0.00073657"],"v":["634.15053067","2117.90194729"],"p":["41908.86644","41673.47236"],"t":[7214,21130],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41896.10000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42243.20000",0,"0.01460168"],"b":["42243.10000",3,"3.82293519"],"c":["42243.20000","0.01398000"],"v":["634.16451067","2117.88824812"],"p":["41908.87381","41673.47318"],"t":[7215,21126],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41898.80000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42255.00000",0,"0.08406816"],"b":["42243.10000",6,"6.33160603"],"c":["42255.00000","0.01593184"],"v":["634.19504419","2117.90471127"],"p":["41908.89020","41673.47996"],"t":[7217,21123],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41908.00000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42254.80000",0,"0.53200000"],"b":["42251.60000",0,"0.10000000"],"c":["42254.80000","0.05800000"],"v":["634.25304419","2117.94005439"],"p":["41908.92184","41673.49337"],"t":[7218,21122],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41922.40000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}
{"event":"heartbeat"}
[324,{"a":["42248.60000",2,"2.84602281"],"b":["42247.00000",0,"0.12500000"],"c":["42248.60000","0.04168347"],"v":["634.29472766","2117.98132192"],"p":["41908.94416","41673.49337"],"t":[7219,21122],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41922.40000"]},"ticker","XBT/USD"]
[324,{"a":["42248.60000",2,"2.83204281"],"b":["42246.90000",0,"0.10000000"],"c":["42248.60000","0.01398000"],"v":["634.30870766","2117.99530192"],"p":["41908.95164","41673.50844"],"t":[7220,21123],"l":["40772.20000","40772.20000"],"h":["42474.30000","42571.50000"],"o":["41016.00000","41922.40000"]},"ticker","XBT/USD"]
{"event":"heartbeat"}
{"event":"heartbeat"}

Należy pamiętać, że wiadomości heartbeat są wysyłane z częstotliwością 1 na sekundę, gdy nie ma dostępnych danych ticker (lub innych danych rynkowych).

Szczegóły poszczególnych pól/wartości w wiadomościach JSON dla kanału ticker (i wszystkich innych kanałów danych rynkowych) są dostępne w naszej dokumentacji WebSocket API v1.

Potrzebujesz więcej pomocy?