调用和返回 (REST API)

上次更新时间： 2025年3月31日

调用


要访问 API 的端点，需要向以下 URL 发送 HTTP 调用。

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"
}
}

需要更多帮助吗？