WebSocket API v1 – Příklad kanálu tržních dat

Naposledy aktualizováno: 31. března 2025

Kanály tržních dat WebSocket API v1 jsou řadou veřejných (neověřených) kanálů, které poskytují stream dostupných obchodních dat v reálném čase (ticker, čas a prodeje, kniha objednávek atd.) pro naše trhy.

Jako živé streamy tržních dat by jakékoli změny tržních dat (například aktualizace nejlepších nákupních/prodejních cen nebo objemů) způsobily odeslání aktualizační zprávy prostřednictvím jednoho nebo více kanálů tržních dat.

Jak se přihlásit k odběru kanálu tržních dat

Jakmile je navázáno připojení k WebSocket API v1 (pomocí veřejné URL adresy wss://ws.kraken.com/), lze se k odběru kanálů tržních dat přihlásit odesláním zprávy o odběru, jako je tato:

  • •

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

Po obdržení platné žádosti o odběr by kanály tržních dat odeslaly potvrzovací zprávu o odběru:

  • •

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

následovaný počátečním snímkem tržních dat (v závislosti na daném kanálu) a poté živým streamem tržních dat v reálném čase.

Příklad živého streamu z kanálu tržních dat

Následuje příklad kanálu ticker, který ilustruje typ zpráv, které jsou přijímány pro různé změny tržních dat (například probíhající obchod způsobující změnu nejlepšího objemu nákupních/prodejních nabídek):

[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.50464"],"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"}

Všimněte si, že zprávy heartbeat jsou odesílány s frekvencí 1 za sekundu, pokud nejsou k dispozici žádná data tickeru (nebo jiná tržní data).

Podrobnosti o jednotlivých polích/hodnotách v JSON zprávách pro kanál ticker (a všechny ostatní kanály tržních dat) jsou k dispozici v naší dokumentaci WebSocket API v1.

Potřebujete další pomoc?