Per accedere agli endpoint dell'API, le chiamate HTTP devono essere inviate al seguente URL.
https://futures.kraken.com/derivatives/api/v3 |
|---|
Per le chiamate agli endpoint privati, devono essere forniti i seguenti header HTTP: apiKey e
authent. L'inclusione del nonce nella richiesta è facoltativa.
Esempio | |
|---|---|
Di seguito è riportato un esempio per l'inclusione degli header HTTP in Java. Per esempi completi e funzionanti in diversi linguaggi di programmazione, consultare la sezione Implementazioni di esempio. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder"; |
Le chiamate agli endpoint che non modificano lo stato del server devono essere inviate con requestType
= GET e con postData inviato nell'URL. Le chiamate agli endpoint che modificano lo stato del server devono essere inviate con requestType = POST e con postData inviato nell'URL. La Sezione 4 descrive in dettaglio per ogni endpoint quale requestType deve essere utilizzato.
I ritorni dell'API sono in formato JSON. Se la chiamata è andata a buon fine, il ritorno include le informazioni richieste
o il feedback sull'azione richiesta. Consultare la Sezione Error! Reference source not found. per una descrizione dei ritorni per ogni endpoint.
Se una chiamata è andata a buon fine, la chiave result nella struttura root avrà il valore success.
Per le chiamate agli endpoint privati, devono essere forniti i seguenti header HTTP: apiKey e
authent.
Esempio | |
|---|---|
Di seguito è mostrato il ritorno di una chiamata riuscita all'endpoint sendorder. |
Si noti che se una chiamata restituisce result uguale a success, ciò significa semplicemente che la richiesta è stata
ricevuta e valutata con successo. Non significa necessariamente che l'operazione desiderata sia stata eseguita. I dettagli sullo stato dell'operazione vengono restituiti in una chiave status, ove applicabile.
Esempio | |
|---|---|
Di seguito è mostrato il ritorno di una chiamata riuscita all'endpoint sendorder in cui l'operazione desiderata non è stata eseguita. { |