WebSocket API v1 – Markkinatietovirran esimerkki

Viimeksi päivitetty: 31.3.2025

WebSocket API v1 -markkinatietovirrat ovat sarja julkisia (todentamattomia) syötteitä, jotka tarjoavat reaaliaikaisen virran saatavilla olevasta kaupankäyntidatasta (ticker, aika ja myynti, tilauskirja jne.) markkinoillemme.

Koska markkinatietovirrat ovat reaaliaikaisia, kaikki markkinatietoihin tehdyt muutokset (kuten parhaiden osto-/myyntihintojen tai volyymien päivitykset esimerkiksi) aiheuttaisivat päivitysviestin lähettämisen yhden tai useamman markkinatietovirran kautta.

Miten markkinatietovirtaan tilataan

Kun yhteys WebSocket API v1:een on muodostettu (käyttäen julkista URL-osoitetta wss://ws.kraken.com/), markkinatietovirtoihin voi tilata lähettämällä tilausviestin seuraavasti:

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

Saatuaan kelvollisen tilauspyynnön markkinatietovirrat lähettäisivät tilausvahvistusviestin:

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

jota seuraa alustava markkinatietojen tilannekuva (riippuen kyseisestä syötteestä) ja sitten reaaliaikainen markkinatietovirta.

Esimerkki reaaliaikaisesta markkinatietovirrasta

Seuraavassa on esimerkki ticker-syötteestä, joka havainnollistaa erityyppisiä viestejä, joita vastaanotetaan markkinatietojen muutoksista (kuten kaupan tapahtumisesta, joka aiheuttaa parhaan osto-/myyntivolyymin muutoksen):

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

Huomaa, että heartbeat-viestejä lähetetään kerran sekunnissa, kun ticker-tietoja (tai muita markkinatietoja) ei ole saatavilla.

Yksittäisten kenttien/arvojen tiedot ticker-syötteen (ja kaikkien muiden markkinatietovirtojen) JSON-viesteissä ovat saatavilla WebSocket API v1 -dokumentaatiossamme.

Tarvitsetko lisää apua?