Κλήσεις και Επιστροφές (REST API)

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

Κλήσεις


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

https://futures.kraken.com/derivatives/api/v3

Για κλήσεις ιδιωτικών τελικών σημείων, πρέπει να παρέχονται οι ακόλουθες κεφαλίδες HTTP: apiKey και
authent. Η συμπερίληψη του nonce στην αίτηση είναι προαιρετική.

Παράδειγμα

Το παρακάτω δείχνει ένα παράδειγμα για τη συμπερίληψη κεφαλίδων HTTP σε Java. Για πλήρη
λειτουργικά παραδείγματα σε διαφορετικές γλώσσες προγραμματισμού, ανατρέξτε στην ενότητα Παραδείγματα Υλοποιήσεων. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder";
URL obj = new URL(url);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
...
con.setRequestProperty("APIKey", apiKey);
con.setRequestProperty("Authent", authent); όπου το apiKey και το authent καθορίζονται όπως περιγράφηκε προηγουμένως.


Οι κλήσεις τελικών σημείων που δεν αλλάζουν την κατάσταση του διακομιστή πρέπει να υποβάλλονται με requestType
= GET και με το postData να υποβάλλεται στη διεύθυνση URL. Οι κλήσεις τελικών σημείων που αλλάζουν την κατάσταση του διακομιστή πρέπει να υποβάλλονται με requestType = POST και με το postData να υποβάλλεται στη διεύθυνση URL. Η Ενότητα 4 περιγράφει λεπτομερώς για κάθε τελικό σημείο ποιος requestType πρέπει να χρησιμοποιείται.

Επιστροφές


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

Εάν μια κλήση ήταν επιτυχής, το κλειδί result στην αρχική δομή θα έχει την τιμή success.

Για κλήσεις ιδιωτικών τελικών σημείων, πρέπει να παρέχονται οι ακόλουθες κεφαλίδες HTTP: apiKey και
authent.

Παράδειγμα

Το παρακάτω δείχνει την επιστροφή μιας επιτυχούς κλήσης του τελικού σημείου sendorder.
{
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"placed",
"order_id":"c18f0c17-9971-40e6-8e5b10df05d422f0"
}
}


Σημειώστε ότι εάν μια κλήση επιστρέψει με result ίσο με success, αυτό σημαίνει απλώς ότι η αίτηση έχει
παραληφθεί και αξιολογηθεί επιτυχώς. Δεν σημαίνει απαραίτητα ότι η επιθυμητή λειτουργία έχει εκτελεστεί. Λεπτομέρειες σχετικά με την κατάσταση της λειτουργίας επιστρέφονται σε ένα κλειδί status, όπου ισχύει.

Παράδειγμα

Το παρακάτω δείχνει την επιστροφή μιας επιτυχούς κλήσης του τελικού σημείου sendorder όπου
η επιθυμητή λειτουργία δεν εκτελέστηκε. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

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