呼叫與回傳（REST API）

最近一次更新： 2026年10月7日

買權


如需存取 API 的各個端點，請向下列 URL 發出 HTTP 要求。

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

呼叫私有 API 端點時，請求中必須提供以下 HTTP 標頭：apiKey 及
authent。請求中是否包含隨機數 (nonce) 為可選項目。

示例

以下示範如何使用 Java 加入 HTTP 標頭。如需查看不同程式語言的完整可執行
示例，請參閱第 範例實作 節。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 的計算方式如前文所述。


不會改變伺服器狀態的 API 端點呼叫，請以 requestType = GET 提交，並將 postData 置於 URL。
會改變伺服器狀態的 API 端點呼叫，請以 requestType = POST 提交，並將 postData 置於 URL。第 4 節詳細說明各 API 端點應使用的 requestType。

返回款項


API 回傳資料格式為 JSON。若呼叫成功，回傳資料包含所請求的
資訊或對應操作的回饋。各 API 端點的回傳說明，請參閱相關章節（參照來源未能解析）。

若呼叫成功，根結構中的「result」鍵將顯示 success。

調用私有 API 端點時，請求中必須提供以下 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"
}
}