WebSocket API v1 - Παράδειγμα ροής δεδομένων αγοράς

Τελευταία ενημέρωση: 31 Μαρτίου 2025

Οι WebSocket API v1 market data feeds είναι μια σειρά από δημόσιες (μη πιστοποιημένες) ροές, οι οποίες παρέχουν μια ροή δεδομένων συναλλαγών σε πραγματικό χρόνο (ticker, time and sales, order book, κ.λπ.) για τις αγορές μας.

Ως ζωντανές ροές δεδομένων αγοράς, τυχόν αλλαγές στα δεδομένα αγοράς (όπως ενημερώσεις στις καλύτερες τιμές bid/ask ή στους όγκους, για παράδειγμα) θα προκαλούσαν την αποστολή ενός μηνύματος ενημέρωσης μέσω μίας ή περισσότερων από τις ροές δεδομένων αγοράς.

Πώς να εγγραφείτε σε μια ροή δεδομένων αγοράς

Μόλις δημιουργηθεί μια σύνδεση με το 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"}}

ακολουθούμενο από ένα αρχικό στιγμιότυπο δεδομένων αγοράς (ανάλογα με τη συγκεκριμένη ροή) και, στη συνέχεια, τη ζωντανή ροή των δεδομένων αγοράς σε πραγματικό χρόνο.

Παράδειγμα ζωντανής ροής από μια ροή δεδομένων αγοράς

Ακολουθεί ένα παράδειγμα της ροής ticker, που απεικονίζει τον τύπο των μηνυμάτων που λαμβάνονται για διάφορες αλλαγές δεδομένων αγοράς (όπως η πραγματοποίηση συναλλαγής που προκαλεί αλλαγή στον όγκο best bid/ask):

[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 ανά δευτερόλεπτο όταν δεν υπάρχουν διαθέσιμα δεδομένα ticker (ή άλλα δεδομένα αγοράς).

Λεπτομέρειες των επιμέρους πεδίων/τιμών εντός των μηνυμάτων JSON για τη ροή ticker (και όλες τις άλλες ροές δεδομένων αγοράς) είναι διαθέσιμες στην τεκμηρίωση WebSocket API v1.

Χρειάζεστε περισσότερη βοήθεια;