呼叫與回傳 (REST API)

上次更新時間： 2025年3月31日

呼叫


若要存取 API 的端點，需要將 HTTP 呼叫傳送至以下 URL。

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

對於私人端點的呼叫，必須提供以下 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 的決定方式如前所述。


不會變更伺服器狀態的端點呼叫應以 requestType
= GET 提交，並將 postData 提交至 URL。會變更伺服器狀態的端點呼叫應以 requestType = POST 提交，並將 postData 提交至 URL。第 4 節詳細說明每個端點應使用的 requestType。

回傳


API 的回傳為 JSON 格式。如果呼叫成功，回傳會包含所請求的
資訊或對所請求動作的回饋。請參閱「錯誤！找不到參考來源」部分，以取得每個端點的回傳說明。

如果呼叫成功，根結構中的 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"
}
}

需要更多幫助？