Chiamate e risposte (REST API)

Ultimo aggiornamento: 7 ottobre 2026

Chiamate


Per accedere agli endpoint dell'API, è necessario inviare chiamate HTTP al seguente URL.

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

Per le chiamate agli endpoint privati, è obbligatorio fornire i seguenti header HTTP: apiKey e
authent. L'inclusione del nonce nella richiesta è facoltativa.

Esempio

Di seguito è riportato un esempio di inclusione degli header HTTP in Java. Per esempi completi e funzionanti in diversi linguaggi di programmazione, consulta la sezione
Implementazioni di esempio. 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); dove apiKey e authent sono determinati come descritto in precedenza.


Le chiamate agli endpoint che non modificano lo stato del server devono essere inviate con requestType
= GET e con postData incluso nell'URL. Le chiamate agli endpoint che modificano lo stato del server devono essere inviate con requestType = POST e con postData incluso nell'URL. La sezione 4 specifica per ciascun endpoint quale requestType utilizzare.

Rendimenti


Le risposte dell'API sono in formato JSON. Se la chiamata ha avuto esito positivo, la risposta include le informazioni richieste o un feedback sull'azione richiesta.
Consulta la sezione Errore! Origine riferimento non trovata. per una descrizione delle risposte di ciascun endpoint.

Se una chiamata ha avuto esito positivo, la chiave result nella struttura radice avrà il valore success.

Per le chiamate agli endpoint privati, è obbligatorio fornire i seguenti header HTTP: apiKey e
authent.

Esempio

Di seguito è riportata la risposta di una chiamata riuscita all'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"
}
}


Tieni presente che se una chiamata restituisce un result uguale a success, ciò significa soltanto che la richiesta è stata ricevuta ed elaborata correttamente.
Non implica necessariamente che l'operazione desiderata sia stata eseguita. I dettagli sullo stato dell'operazione sono restituiti in una chiave status, ove applicabile.

Esempio

Di seguito è riportata la risposta di una chiamata riuscita all'endpoint sendorder in cui l'operazione desiderata non è stata eseguita. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}