Виклики та відповіді (REST API)

Останнє оновлення: 7 жовтня 2026 р.

Виклики


Для доступу до кінцевих точок API необхідно надсилати HTTP-запити на вказану URL-адресу.

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

Для викликів приватних кінцевих точок необхідно передавати такі HTTP-заголовки: apiKey і
authent. Включення nonce до запиту є необовʼязковим.

Наприклад

Нижче наведено приклад включення HTTP-заголовків у 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 визначаються так, як описано раніше.


Коли кінцева точка не змінює стан сервера, запит слід надсилати з requestType
= GET, а postData передається в URL. Коли кінцева точка змінює стан сервера, запит слід надсилати з requestType = POST, а postData передається в URL. Розділ 4 містить інформацію про те, який requestType слід використовувати для кожної кінцевої точки.

Дохідність


Відповіді API повертаються у форматі JSON. У разі успішного виклику відповідь містить запитану
інформацію або підтвердження виконаної дії. Опис відповідей для кожної кінцевої точки наведено в розділі Error! Reference source not found.

У разі успішного виклику ключ result у кореневій структурі матиме значення success.

Для викликів приватних кінцевих точок необхідно передавати такі HTTP-заголовки: apiKey і
authent.

Наприклад

Нижче наведено відповідь на успішний виклик кінцевої точки 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 деталі щодо статусу операції повертаються в ньому.

Наприклад

Нижче наведено відповідь на успішний виклик кінцевої точки sendorder, коли бажану операцію не було виконано. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}