Канали ринкових даних 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.