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

Останнє оновлення: 31 бер. 2025 р.

Виклики


Щоб отримати доступ до кінцевих точок 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. Якщо виклик був успішним, відповідь містить запитувану
інформацію або відгук про запитувану дію. Опис відповідей для кожної кінцевої точки дивіться в розділі Помилка! Джерело посилання не знайдено.

Якщо виклик був успішним, ключ результату в кореневій структурі матиме значення 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"
}
}


Зверніть увагу, що якщо виклик повертається з результатом, що дорівнює success, це лише означає, що запит був
успішно отриманий та оцінений. Це не обов'язково означає, що бажана операція була виконана. Деталі щодо статусу операції повертаються в ключі статусу, де це застосовно.

Приклад

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

Потрібна додаткова допомога?