WebSocket API v1 - Exempel på marknadsdataflöde

Senast uppdaterad: 31 mars 2025

De WebSocket API v1 marknadsdataflödena är en serie offentliga (oautentiserade) flöden som tillhandahåller en realtidsström av tillgänglig handelsdata (ticker, tid och försäljning, orderbok, etc.) för våra marknader.

Som live marknadsdataflöden skulle alla ändringar i marknadsdata (såsom uppdateringar av bästa köp-/säljpriser eller volymer, till exempel) orsaka att ett uppdateringsmeddelande skickas via ett eller flera av marknadsdataflödena.

Hur man prenumererar på ett marknadsdataflöde

När en anslutning till WebSocket API v1 har upprättats (med den offentliga URL:en wss://ws.kraken.com/), kan marknadsdataflödena prenumereras på genom att skicka ett prenumerationsmeddelande som följande:

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

Vid mottagande av en giltig prenumerationsförfrågan skulle marknadsdataflödena skicka ett prenumerationsbekräftelsemeddelande:

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

följt av en initial marknadsdata-snapshot (beroende på det aktuella flödet), och sedan live-strömmen av realtidsmarknadsdata.

Exempel på live-ström från ett marknadsdataflöde

Följande är ett exempel på ticker-flödet, som illustrerar vilken typ av meddelanden som tas emot för olika marknadsdataändringar (såsom en handel som orsakar att bästa köp-/säljvolymen ändras):

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

Observera att heartbeat-meddelanden skickas med en frekvens av 1 per sekund när ingen ticker (eller annan marknadsdata) är tillgänglig.

Detaljer om de enskilda fälten/värdena inom JSON-meddelandena för ticker-flödet (och alla andra marknadsdataflöden) finns tillgängliga i vår WebSocket API v1-dokumentation.

Behöver du mer hjälp?