De WebSocket API v1 marktdatafeeds zijn een reeks openbare (niet-geauthenticeerde) feeds die een realtime stroom van de beschikbare handelsgegevens (ticker, tijd en verkopen, orderboek, enz.) voor onze markten leveren.
Als live marktdatafeeds zouden eventuele wijzigingen in de marktdata (zoals updates van de beste bied-/laatprijzen of volumes, bijvoorbeeld) een updatemelding veroorzaken die via een of meer van de marktdatafeeds wordt verzonden.
Zodra een verbinding met de WebSocket API v1 tot stand is gebracht (met behulp van de openbare URL wss://ws.kraken.com/), kan men zich abonneren op de marktdatafeeds door een abonnementsbericht te sturen zoals het volgende:
{"event":"subscribe", "subscription":{"name":"ticker"}, "pair":["BTC/USD"]}
Na ontvangst van een geldig abonnementsverzoek sturen de marktdatafeeds een abonnementsbevestigingsbericht:
{"channelID":324,"channelName":"ticker","event":"subscriptionStatus","pair":"XBT/USD","status":"subscribed","subscription":{"name":"ticker"}}
gevolgd door een initiële momentopname van de marktdata (afhankelijk van de betreffende feed), en vervolgens de live stream van de realtime marktdata.
Het volgende is een voorbeeld van de ticker feed, die het type berichten illustreert dat wordt ontvangen voor verschillende marktdatawijzigingen (zoals een transactie die een verandering in het beste bied-/laatvolume veroorzaakt):
[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"}
Merk op dat heartbeat-berichten met een frequentie van 1 per seconde worden verzonden wanneer er geen ticker (of andere marktdata) beschikbaar is.
Details van de individuele velden/waarden binnen de JSON-berichten voor de ticker feed (en alle andere marktdatafeeds) zijn beschikbaar in onze WebSocket API v1 documentatie.