Αιτήματα και Αποκρίσεις (REST API)

Τελευταία ενημέρωση: 7 Οκτωβρίου 2026

Κλήσεις


Για πρόσβαση στα endpoints του API, τα HTTP αιτήματα πρέπει να αποστέλλονται στην παρακάτω URL.

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

Για αιτήματα σε private endpoints, πρέπει να παρέχονται τα εξής HTTP headers: apiKey και
authent. Η συμπερίληψη του nonce στο αίτημα είναι προαιρετική.

Παράδειγμα

Παρακάτω παρουσιάζεται ένα παράδειγμα συμπερίληψης HTTP headers σε 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 καθορίζονται όπως περιγράφεται παραπάνω.


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

Αποδόσεις


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

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

Για αιτήματα σε private endpoints, πρέπει να παρέχονται τα εξής HTTP headers: apiKey και
authent.

Παράδειγμα

Παρακάτω παρουσιάζεται η απόκριση ενός επιτυχούς αιτήματος στο endpoint 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, όπου αυτό ισχύει.

Παράδειγμα

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