Apeluri și răspunsuri (API REST)

Ultima actualizare: 7 octombrie 2026

Oferte call


Pentru a accesa endpointurile API, apelurile HTTP trebuie trimise la următorul URL.

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

Pentru apelurile către endpointurile private, trebuie furnizate următoarele headere HTTP: apiKey și
authent. Includerea nonce în solicitare este opțională.

Exemplu

Mai jos este prezentat un exemplu de includere a headerelor HTTP în Java. Pentru exemple complete în diferite limbaje de programare, consultați Secțiunea Implementări exemplu. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder";
pentru exemple complete în diferite limbaje de programare, consultați Secțiunea Implementări exemplu. 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); unde apiKey și authent sunt determinate conform descrierii anterioare.


Apelurile către endpointurile care nu modifică starea serverului trebuie trimise cu requestType
= GET, cu postData inclus în URL. Apelurile către endpointurile care modifică starea serverului trebuie trimise cu requestType = POST, cu postData inclus în URL. Secțiunea 4 specifică pentru fiecare endpoint ce requestType trebuie utilizat.

Returnează


Răspunsurile API-ului sunt în format JSON. Dacă apelul a fost efectuat cu succes, răspunsul include informațiile solicitate sau confirmarea acțiunii cerute.
informațiile solicitate sau confirmarea acțiunii cerute. Consultați Secțiunea Eroare! Sursă de referință negăsită. pentru o descriere a răspunsurilor fiecărui endpoint.

Dacă un apel a fost efectuat cu succes, cheia result din structura rădăcină va avea valoarea success.

Pentru apelurile către endpointurile private, trebuie furnizate următoarele headere HTTP: apiKey și
authent.

Exemplu

Mai jos este prezentat răspunsul unui apel reușit către endpointul 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"
}
}


Reține că un rezultat success înseamnă doar că solicitarea a fost
primită și procesată cu succes. Acest lucru nu înseamnă neapărat că operațiunea dorită a fost efectuată. Detaliile privind starea operațiunii sunt returnate într-o cheie status, acolo unde este cazul.

Exemplu

Mai jos este prezentat răspunsul unui apel reușit către endpointul sendorder în care operațiunea dorită nu a fost efectuată. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}