请求与返回（REST API）

最近更新 2026年10月7日

看涨期权


如需访问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中提交。各接口端点应使用的requestType详见第4节。

回报


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