Συχνές ερωτήσεις για προχωρημένους σχετικά με το API

Τελευταία ενημέρωση: 5 Νοεμβρίου 2026

Χρησιμοποιώντας τα REST API endpoints χρηματοδότησης, οι πελάτες μπορούν να πραγματοποιούν κατάθεση/ανάληψη κεφαλαίων προς/από τον λογαριασμό Kraken τους και να ζητούν την κατάσταση σε πραγματικό χρόνο μιας συναλλαγής κατάθεσης/ανάληψης.

Οι καταθέσεις/αναλήψεις περνούν από διάφορα στάδια, από το αρχικό αίτημα έως την ολοκλήρωση της συναλλαγής. Επομένως, τα endpoints χρηματοδότησης επιστρέφουν διαφορετική τιμή κατάστασης, ανάλογα με το πότε καλούνται.

Σημειώστε ότι οι τιμές κατάστασης προέρχονταν αρχικά από τις σελίδες 16/17 του εγγράφου Internet Financial Exchange Protocol (IFEX), αλλά τροποποιήθηκαν ελαφρώς ώστε να είναι καταλληλότερες για συναλλαγές κρυπτονομισμάτων (για παράδειγμα, δεν χρησιμοποιούνται όλες οι πιθανές τιμές κατάστασης).

Καταθέσεις

Οι πιθανές τιμές κατάστασης για τις συναλλαγές κατάθεσης είναι οι εξής:

  • •

    Ολοκληρώθηκε = Η κατάθεση έχει ληφθεί, αλλά χρειάζεται ακόμη πρόσθετες επιβεβαιώσεις στο blockchain.

  • •

    Επιτυχία = Η κατάθεση έχει λάβει τον απαιτούμενο αριθμό επιβεβαιώσεων στο blockchain.

  • •

    Αποτυχία = Η κατάθεση απέτυχε (για έναν ή περισσότερους από διάφορους λόγους).

Ακολουθούν ορισμένα παραδείγματα για το πώς θα εμφανίζονταν οι παραπάνω τιμές κατάστασης στις απαντήσεις από το endpoint DepositStatus:

Κατάσταση ολοκλήρωσης:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}

Κατάσταση επιτυχίας:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}

Αναλήψεις

Οι πιθανές τιμές κατάστασης για τις συναλλαγές ανάληψης είναι οι εξής:

  • •

    Αρχική = Το αίτημα ανάληψης έχει ληφθεί και ελέγχεται ως προς την εγκυρότητά του (τυχόν περιορισμοί χρηματοδότησης στον λογαριασμό κ.λπ.).

  • •

    Σε αναμονή = Η ανάληψη περιμένει να υποβληθεί σε επεξεργασία από την πύλη χρηματοδότησής μας.

  • •

    Ολοκληρώθηκε = Η ανάληψη έχει αποσταλεί στο blockchain (σε αυτό το σημείο θα είναι διαθέσιμο το ID της συναλλαγής στο blockchain).

  • •

    Επιτυχία = Η συναλλαγή ανάληψης έχει τουλάχιστον 1 επιβεβαίωση στο blockchain.

  • •

    Σε αναμονή = Η ανάληψη έχει τεθεί σε αναμονή και πρέπει να ελεγχθεί χειροκίνητα από την ομάδα χρηματοδότησής μας.

  • •

    Αποτυχία = Η ανάληψη απέτυχε (για έναν ή περισσότερους από διάφορους λόγους).

The following are some examples of how the above status values would appear in responses from the WithdrawStatus endpoint:

Initial status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}

Pending status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Settled status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}

Success status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}

Failure status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}

Additional information regarding deposits/withdrawals are available via our cash funding and crypto funding support pages.

Το endpoint OHLC του REST API παρέχει μόνο περιορισμένο όγκο ιστορικών δεδομένων, συγκεκριμένα 720 σημεία δεδομένων για το ζητούμενο διάστημα. Για παράδειγμα, αν ζητήσετε δεδομένα OHLC σε διαστήματα του 1 λεπτού, θα επιστραφούν τα πιο πρόσφατα 720 λεπτά (12 ώρες) δεδομένων.

Για εφαρμογές που απαιτούν πρόσθετα δεδομένα OHLC ή tick, μπορείτε να ανακτήσετε ολόκληρο το ιστορικό συναλλαγών των αγορών μας (τον ιστορικό χρόνο και τις πωλήσεις) μέσω του endpoint Trades του REST API. Στη συνέχεια μπορείτε να δημιουργήσετε τα δεδομένα OHLC για οποιοδήποτε χρονικό πλαίσιο και διάστημα από τα ιστορικά δεδομένα χρόνου και πωλήσεων.

Το endpoint Trades δέχεται μια προαιρετική παράμετρο με το όνομα since, η οποία καθορίζει την ημερομηνία/ώρα έναρξης των δεδομένων. Η τιμή since είναι μια χρονική σήμανση UNIX με ανάλυση νανοδευτερολέπτου (μια τυπική χρονική σήμανση UNIX σε δευτερόλεπτα με 9 επιπλέον ψηφία).

Για παράδειγμα, μια κλήση στο endpoint Trades όπως η https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000 θα επέστρεφε τα ιστορικά δεδομένα χρόνου και πωλήσεων για το XBT/USD από την 1η Ιουνίου 2019 στις 00:00:00 UTC:

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

Στις επόμενες κλήσεις στο endpoint Trades, θα πρέπει να αντικαθιστάτε την τιμή της παραμέτρου since με την τιμή της παραμέτρου last από τα αποτελέσματα της προηγούμενης κλήσης όπως στην https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

Η χρήση της ειδικής τιμής since ίσης με 0 (μηδέν) θα επέστρεφε τα ιστορικά δεδομένα χρόνου και πωλήσεων από την αρχή της αγοράς (ξεκινώντας από την πρώτη συναλλαγή).

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

Οι αναφορές χρήστη έχουν σχεδιαστεί ώστε να είναι όσο το δυνατόν πιο ευέλικτες και, επομένως, μπορούν να χρησιμοποιηθούν με διάφορους τρόπους, όπως:

  • •

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

  • •

    για την ομαδοποίηση σχετικών εντολών (όπως η ομαδοποίηση εντολών με διαφορετικά επίπεδα μόχλευσης),

  • •

    ή ως εφεδρικό αναγνωριστικό σε περίπτωση που δεν είναι γνωστό το πραγματικό αναγνωριστικό εντολής.

Μια αναφορά χρήστη πρέπει να είναι αριθμητική τιμή μεταξύ 1 και 2.147.483.647 (ουσιαστικά οποιοσδήποτε θετικός αριθμός 32 bit) και, επομένως, μπορεί να υλοποιηθεί ως ένας απλός μετρητής, ως μια τυχαία προσημασμένη τιμή 32 bit ή ακόμη και ως χρονική σήμανση σε δευτερόλεπτα (αν και αυτό θα έπαυε να λειτουργεί μετά τις 19 Ιανουαρίου 2038 στις 3:14:07 UTC).

Τοποθέτηση εντολών με αναφορά χρήστη

Μπορείτε να τοποθετήσετε εντολές με επισυναπτόμενη αναφορά χρήστη καλώντας το endpoint AddOrder και συμπεριλαμβάνοντας την παράμετρο userref, με την αναφορά χρήστη ως τιμή:

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=limit price=0.1 volume=50 userref=27649653

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ limit 0.1000000"},"txid":["OQJSXE-F5FOM-IXHVL4"]}}

Προβολή εντολών στις οποίες έχει αντιστοιχιστεί αναφορά χρήστη

Οι εντολές στις οποίες έχει ήδη αντιστοιχιστεί μια αναφορά χρήστη μπορούν να προβληθούν καλώντας τα endpoint Open/Closed/QueryOrders και συμπεριλαμβάνοντας την παράμετρο userref, με την υπάρχουσα αναφορά χρήστη ως τιμή (σε αυτήν την περίπτωση, η αναφορά χρήστη λειτουργεί ως φίλτρο και εμφανίζει μόνο τις σχετικές εντολές):

$ ./krakenapi OpenOrders userref=27649653

{"error":[],"result":{"open":{"OQJSXE-F5FOM-IXHVL4":{"refid":null,"userref":27649653,"status":"open","opentm":1629618802.9812,"starttm":0,"expiretm":0,"descr":{"pair":"XDGUSD","type":"buy","ordertype":"limit","price":"0.1000000","price2":"0","leverage":"none","order":"buy 50.00000000 XDGUSD @ limit 0.1000000","close":""},"vol":"50.00000000","vol_exec":"0.00000000","cost":"0.000000000","fee":"0.000000000","price":"0.000000000","stopprice":"0.000000000","limitprice":"0.000000000","misc":"","oflags":"fciq"}}}}

$ ./krakenapi ClosedOrders userref=38695724

{"error":[],"result":{"closed":{"O7YEFN-3V4RK-FBNSNM":{"refid":null,"userref":38695724,"status":"canceled","reason":"User requested","opentm":1629619539.3593,"closetm":1629619542.2246,"starttm":0,"expiretm":0,"descr":{"pair":"XBTUSD","type":"buy","ordertype":"limit","price":"25000.0","price2":"0","leverage":"none","order":"buy 0.00010000 XBTUSD @ limit 25000.0","close":""},"vol":"0.00010000","vol_exec":"0.00000000","cost":"0.00000","fee":"0.00000","price":"0.00000","stopprice":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq"}},"count":1}}

Ακύρωση εντολών στις οποίες έχει αντιστοιχιστεί αναφορά χρήστη

Οι εντολές στις οποίες έχει ήδη αντιστοιχιστεί μια αναφορά χρήστη μπορούν να ακυρωθούν χρησιμοποιώντας την αναφορά χρήστη, καλώντας το endpoint CancelOrder και χρησιμοποιώντας την αναφορά χρήστη ως τιμή txid (αντί για την τιμή του αναγνωριστικού εντολής):

$ ./krakenapi CancelOrder txid=16764529

{"error":[],"result":{"count":1}}

Σημειώστε ότι όλες οι ανοιχτές εντολές με την ίδια αναφορά χρήστη θα ακυρώνονταν. Επομένως, είναι δυνατή η πραγματοποίηση μίας κλήσης CancelOrder για την ταυτόχρονη ακύρωση πολλών εντολών (όπως υποδεικνύεται από την τιμή count ίση με 3 στην ακόλουθη απόκριση):

$ ./krakenapi CancelOrder txid=48695624

{"error":[],"result":{"count":3}}

Αυτό το ζήτημα μπορεί να σχετίζεται με το Cloudflare:

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

ΣΗΜΕΙΩΣΗ: Η Kraken έχει ενεργοποιημένο το "Browser Integrity Check".

Αυτό μπορεί να συμβεί αν το αίτημά σας περιέχει ύποπτες κεφαλίδες. Για παράδειγμα, μπορεί να λείπει από το αίτημά σας ένας user agent ή να χρησιμοποιείται ένας μη τυπικός user agent· επομένως, ελέγξτε τις κεφαλίδες του αιτήματός σας.

Αν δεν μπορείτε να δημιουργήσετε τυπικά αιτήματα που επιτρέπονται από το σύστημά μας, στείλτε μας ένα πλήρες αντίγραφο των αιτημάτων που προσπαθείτε να υποβάλετε, συμπεριλαμβανομένης της διεύθυνσης IP σας και όλων των κεφαλίδων. Αυτές οι πληροφορίες θα μας επιτρέψουν να διερευνήσουμε περαιτέρω το ζήτημα.

Περιβάλλοντα δοκιμών REST, WebSocket και FIX

Για το spot REST/WebSocket API και το FIX API, καθώς και για το Derivative REST/WebSocket API και το FIX API, προσφέρουμε επί του παρόντος ένα περιβάλλον δοκιμών για εξουσιοδοτημένους πελάτες. Η πρόσβαση σε αυτό το περιβάλλον απαιτεί μια διαδικασία εγγραφής, η οποία μπορεί να ξεκινήσει επικοινωνώντας απευθείας με την ομάδα API.

Δοκιμή του API μας με τη δοκιμαστική παράμετρο Validate

Κατά την υποβολή μιας εντολής μέσω του endpoint AddOrder του REST API ή του endpoint addOrder του WebSocket API, η παράμετρος εισόδου validate μπορεί να χρησιμοποιηθεί για την προσομοίωση της εντολής.

Η κλήση των AddOrder/addOrder με την παράμετρο validate ορισμένη σε true (validate=1, validate=true, validate=anything κ.λπ.) θα προκαλέσει τον έλεγχο των στοιχείων της εντολής για σφάλματα, αλλά η απόκριση του API δεν θα περιλαμβάνει ποτέ αναγνωριστικό εντολής (το οποίο θα επιστρεφόταν πάντα για μια επιτυχημένη εντολή χωρίς την παράμετρο validate).

Παράδειγμα κλήσης AddOrder με την παράμετρο validate (σημειώστε ότι λείπει το αναγνωριστικό εντολής):

bash

Bash

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}

Μικρές πραγματικές εντολές ή/και εντολές με ακραίες τιμές

Για μια ολοκληρωμένη δοκιμή API με τη χρήση της παραμέτρου Validate, συνιστούμε να τοποθετήσετε πολύ μικρές εντολές αγοράς (εντολές για το ελάχιστο μέγεθος εντολής) ή εντολές limit με τιμές πολύ μακριά από την τρέχουσα τιμή αγοράς (για παράδειγμα, τοποθετώντας μια εντολή limit για πώληση ETH/USD στα 800 $, όταν η τιμή αγοράς είναι 200 $).

Η δοκιμή με πραγματικές εντολές επιτρέπει στον κώδικα API σας να αλληλεπιδρά με το API μας σε πραγματικές συνθήκες. Επομένως, κάθε πτυχή της δοκιμής θα είναι ακριβής, όπως ο τρόπος με τον οποίο οι εντολές σας επηρεάζουν το βιβλίο εντολών κ.λπ.

Για λόγους ασφάλειας, καταργήσαμε πρόσφατα την υποστήριξη για TLS 1.0 και 1.1. Αν εμφανίζονται μηνύματα σφάλματος σύνδεσης SSL/TLS όταν προσπαθείτε να συνδεθείτε στο API μας, πιθανότατα αυτό οφείλεται στη χρήση ενός από αυτά τα παρωχημένα πρότυπα. Θα χρειαστεί να τροποποιήσετε το πρόγραμμα-πελάτη API ώστε να επιβάλλεται η χρήση των TLS 1.2/1.3 ή να αναβαθμίσετε την έκδοση του .NET σε 4.6 ή νεότερη, η οποία χρησιμοποιεί από προεπιλογή τα TLS 1.2/1.3.

Μπορείτε να χρησιμοποιήσετε το ακόλουθο Google Sheet για να υπολογίσετε την υπογραφή ελέγχου ταυτότητας REST API για οποιονδήποτε συνδυασμό δεδομένων εισόδου:

  • •

    Ιδιωτικό (μυστικό) κλειδί API

  • •

    endpoint API (Balance, TradeBalance, QueryOrders κ.λπ.)

  • •

    Τιμή nonce (ανατρέξτε στη σελίδα υποστήριξής μας τι είναι το nonce για περισσότερες λεπτομέρειες)

  • •

    Παράμετροι εισόδου endpoint (asset=doge, για παράδειγμα)

Η αριθμομηχανή μπορεί να χρησιμοποιηθεί για να επαληθεύσετε ότι ο αλγόριθμος ελέγχου ταυτότητας έχει υλοποιηθεί σωστά, αποφεύγοντας έτσι πιθανά προβλήματα, ιδίως σφάλματα μη έγκυρου κλειδιού, αργότερα στον κύκλο ανάπτυξης.

Οδηγίες χρήσης

  1. 1

    Ανοίξτε την αριθμομηχανή ελέγχου ταυτότητας REST API στο Chrome ή σε οποιοδήποτε άλλο πρόσφατο πρόγραμμα περιήγησης ιστού.

  2. 2

    Δημιουργήστε ένα αντίγραφο της αριθμομηχανής στο δικό σας Google Drive μέσω του μενού File -> Make a copy (για αυτό το βήμα θα χρειαστεί να συνδεθείτε στον λογαριασμό σας Google).

  3. 3

    Επεξεργαστείτε τα πεδία API key, API endpoint, nonce value και input data με το δικό σας κλειδί API και τις λεπτομέρειες του αιτήματος.

  4. 4

    Συγκρίνετε την υπολογισμένη υπογραφή ελέγχου ταυτότητας API με την τιμή που υπολογίζει ο δικός σας κώδικας API (οι δύο τιμές πρέπει να ταιριάζουν απόλυτα).

Για λόγους ασφάλειας, συνιστούμε να χρησιμοποιήσετε την αριθμομηχανή ελέγχου ταυτότητας με ένα προσωρινό κλειδί API και, στη συνέχεια, να διαγράψετε το κλειδί API από τον λογαριασμό σας μόλις επιβεβαιωθεί ότι η υλοποίηση της υπογραφής ελέγχου ταυτότητας είναι σωστή.

Παράδειγμα

Screenshot_2021-06-21_at_14.42.35.png

Το σημαντικότερο πλεονέκτημα της χρήσης των wrappers της βιβλιοθήκης προγράμματος-πελάτη μας είναι ότι δεν χρειάζεται να αφιερώσετε χρόνο και προσπάθεια για να δημιουργήσετε από την αρχή υπογραφές API· η διαδικασία έχει ήδη ολοκληρωθεί για εσάς.

Αν σκοπεύετε να πραγματοποιείτε κλήσεις μόνο σε δημόσιες μεθόδους, μπορείτε να επιλέξετε να μην χρησιμοποιήσετε βιβλιοθήκες προγράμματος-πελάτη, καθώς δεν απαιτείται έλεγχος ταυτότητας.

Μπορείτε να βρείτε εδώ τη λίστα με τα διαθέσιμα wrappers.