Apeluri și Răspunsuri (REST API)

Ultima actualizare: 31 martie 2025

Apeluri


Pentru a accesa endpoint-urile API, apelurile HTTP trebuie trimise la următoarea URL.

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

Pentru apelurile către endpoint-uri private, trebuie furnizate următoarele anteturi HTTP: apiKey și
authent. Includerea nonce în cerere este opțională.

Exemplu

Următorul exemplu arată includerea anteturilor HTTP în Java. Pentru exemple complete
de lucru în diferite limbaje de programare, consultați Secțiunea Implementări eșantion. 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 așa cum a fost descris anterior.


Apelurile către endpoint-uri care nu modifică starea serverului ar trebui trimise cu requestType
= GET și cu postData trimise în URL. Apelurile către endpoint-uri care modifică starea serverului ar trebui trimise cu requestType = POST și cu postData trimise în URL. Secțiunea 4 detaliază pentru fiecare endpoint ce requestType ar trebui utilizat.

Răspunsuri


Răspunsurile API sunt în format JSON. Dacă apelul a avut succes, răspunsul include informațiile solicitate
sau feedback-ul privind acțiunea solicitată. Consultați Secțiunea Error! Reference source not found. pentru o descriere a răspunsurilor pentru fiecare endpoint.

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

Pentru apelurile către endpoint-uri private, trebuie furnizate următoarele anteturi HTTP: apiKey și
authent.

Exemplu

Următorul exemplu arată răspunsul unui apel reușit al endpoint-ului 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ți că, dacă un apel returnează result egal cu success, acest lucru înseamnă doar că cererea a fost
primită și evaluată cu succes. 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

Următorul exemplu arată răspunsul unui apel reușit al endpoint-ului sendorder, unde 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"
}
}

Ai nevoie de mai mult ajutor?