WebSocket API v1 — Пример потока рыночных данных

Последнее обновление: 31 мар. 2025 г.

Потоки рыночных данных WebSocket API v1 представляют собой серию общедоступных (неаутентифицированных) потоков, которые обеспечивают передачу в реальном времени доступных торговых данных (тикер, время и продажи, книга ордеров и т. д.) для наших рынков.

Поскольку это потоки рыночных данных в реальном времени, любые изменения в рыночных данных (например, обновления лучших цен покупки/продажи или объемов) вызовут отправку сообщения об обновлении через один или несколько потоков рыночных данных.

Как подписаться на поток рыночных данных

После установления соединения с WebSocket API v1 (с использованием общедоступного URL-адреса wss://ws.kraken.com/) на потоки рыночных данных можно подписаться, отправив сообщение о подписке, как показано ниже:

  • •

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

После получения действительного запроса на подписку потоки рыночных данных отправят сообщение с подтверждением подписки:

  • •

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

за которым последует первоначальный снимок рыночных данных (в зависимости от соответствующего потока), а затем прямая трансляция рыночных данных в реальном времени.

Пример потока рыночных данных в реальном времени

Ниже приведен пример потока тикера, иллюстрирующий тип сообщений, которые получаются при различных изменениях рыночных данных (например, при совершении сделки, вызывающей изменение объема лучшей цены покупки/продажи):

[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"}

Обратите внимание, что сообщения heartbeat отправляются с частотой 1 раз в секунду, когда нет доступных данных тикера (или других рыночных данных).

Подробная информация об отдельных полях/значениях в сообщениях JSON для потока тикера (и всех других потоков рыночных данных) доступна в нашей документации WebSocket API v1.

Нужна дополнительная помощь?