高级 API 常见问题

上次更新时间： 2025年11月25日

存款/提款交易的可能状态值

使用 REST API 资金端点，客户可以向其 Kraken 账户存入/提取资金，并请求存款/提款交易的实时状态。

存款/提款会经历从初始请求到交易完成的几个阶段，因此资金端点会根据调用时间返回不同的状态值。

请注意，这些状态值最初来自 Internet Financial Exchange Protocol (IFEX) 文档的第 16/17 页，但这些值已略作修改，以更适用于加密货币交易（例如，并非所有可能的状态值都已使用）。

存款

存款交易的可能状态值如下：

•
Settled = 存款已收到，但仍需在区块链上进行额外确认。
•
Success = 存款已在区块链上达到所需的确认数量。
•
Failure = 存款失败（原因可能有一个或多个）。

以下是上述状态值在 DepositStatus 端点响应中显示的一些示例：

Settled status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}

Success status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}

提款

提款交易的可能状态值如下：

•
Initial = 提款请求已收到，正在检查其有效性（例如，账户是否有任何资金限制）。
•
Pending = 提款正在等待我们的资金网关处理。
•
Settled = 提款已发送到区块链（此时区块链交易 ID 将可用）。
•
Success = 提款交易在区块链上至少有 1 次确认。
•
On hold = 提款已被暂停，需要由我们的资金团队手动检查。
•
Failure = 提款失败（原因可能有一个或多个）。

以下是上述状态值在 WithdrawStatus 端点响应中显示的一些示例：

Initial status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}

Pending status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Settled status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}

Success status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}

Failure status:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}

有关存款/提款的更多信息，请访问我们的现金资金和加密货币资金支持页面。

如何使用 REST API Trades 端点检索历史时间和销售数据（交易历史）

REST API OHLC 端点仅提供有限的历史数据，具体来说是所请求时间间隔的 720 个数据点。例如，请求 1 分钟间隔的 OHLC 数据将返回最近 720 分钟（12 小时）的数据。

对于需要额外 OHLC 或逐笔报价数据的应用程序，可以通过REST API Trades 端点检索我们市场的完整交易历史（历史时间和销售数据）。任何时间范围和任何间隔的 OHLC 都可以从历史时间和销售数据中创建。

Trades 端点接受一个名为 since 的可选参数，该参数指定数据的开始日期/时间。since 值是一个纳秒分辨率的 UNIX 时间戳（一个标准的 UNIX 时间戳，以秒为单位，附加 9 位数字）。

例如，对 Trades 端点的调用，例如 https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000，将返回从 2019 年 6 月 1 日 00:00:00 UTC 开始的 XBT/USD 历史时间和销售数据：

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

对 Trades 端点的后续调用应将 since 参数的值替换为上次调用结果中的 last 参数值，例如 https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117。

使用特殊的 since 值 0（零）将返回从市场开始（从第一笔交易开始）的历史时间和销售数据。

如何使用用户参考下达、查看和取消订单

用户参考是客户提供的订单 ID，可用于某些订单管理任务（特别是取消订单）中替代实际（API 提供）的订单 ID。

用户参考的实现尽可能灵活，因此可以通过多种不同方式使用，包括：

•
作为唯一 ID（每个订单都有不同的用户参考），
•
将相关订单分组（例如，将具有不同杠杆水平的订单分组），
•
或在实际订单 ID 未知时作为备用 ID。

用户参考必须是介于 1 和 2,147,483,647 之间的数值（本质上是任何正的 32 位数字），因此可以实现为简单的计数器、随机的带符号 32 位值，甚至是以秒为单位的时间戳（尽管这将在 2038 年 1 月 19 日 03:14:07 UTC 之后失效）。

下达带有用户参考的订单

可以通过调用 AddOrder 端点并包含 userref 参数及其用户参考值来下达带有附加用户参考的订单：

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=limit price=0.1 volume=50 userref=27649653

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ limit 0.1000000"},"txid":["OQJSXE-F5FOM-IXHVL4"]}}

查看带有用户参考的订单

可以通过调用 Open/Closed/QueryOrders 端点并包含 userref 参数及其现有用户参考值来查看已附加用户参考的订单（在这种情况下，用户参考充当过滤器，仅显示相关订单）：

$ ./krakenapi OpenOrders userref=27649653

{"error":[],"result":{"open":{"OQJSXE-F5FOM-IXHVL4":{"refid":null,"userref":27649653,"status":"open","opentm":1629618802.9812,"starttm":0,"expiretm":0,"descr":{"pair":"XDGUSD","type":"buy","ordertype":"limit","price":"0.1000000","price2":"0","leverage":"none","order":"buy 50.00000000 XDGUSD @ limit 0.1000000","close":""},"vol":"50.00000000","vol_exec":"0.00000000","cost":"0.000000000","fee":"0.000000000","price":"0.000000000","stopprice":"0.000000000","limitprice":"0.000000000","misc":"","oflags":"fciq"}}}}

$ ./krakenapi ClosedOrders userref=38695724

{"error":[],"result":{"closed":{"O7YEFN-3V4RK-FBNSNM":{"refid":null,"userref":38695724,"status":"canceled","reason":"User requested","opentm":1629619539.3593,"closetm":1629619542.2246,"starttm":0,"expiretm":0,"descr":{"pair":"XBTUSD","type":"buy","ordertype":"limit","price":"25000.0","price2":"0","leverage":"none","order":"buy 0.00010000 XBTUSD @ limit 25000.0","close":""},"vol":"0.00010000","vol_exec":"0.00000000","cost":"0.00000","fee":"0.00000","price":"0.00000","stopprice":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq"}},"count":1}}

取消带有用户参考的订单

可以通过调用 CancelOrder 端点并使用用户参考作为 txid 值（代替订单 ID 值）来取消已附加用户参考的订单：

$ ./krakenapi CancelOrder txid=16764529

{"error":[],"result":{"count":1}}

请注意，所有具有相同用户参考的未结订单都将被取消，因此可以通过一次 CancelOrder 调用同时取消多个订单（如下面响应中 count 值为 3 所示）：

$ ./krakenapi CancelOrder txid=48695624

{"error":[],"result":{"count":3}}

为什么我在使用 Kraken API 时收到 403 错误？

此问题可能与 Cloudflare 有关：

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

注意：Kraken 已启用“浏览器完整性检查”。

如果您的请求包含可疑标头，则可能会发生此情况。例如，您的请求可能缺少用户代理，或使用非标准用户代理；因此请检查您的请求标头。

如果您无法创建我们系统允许的任何标准请求，请向我们发送您尝试的请求的完整副本，包括您的 IP 地址和所有标头。此信息将有助于我们进一步调查。

Kraken 是否提供 API 测试环境？

期货 API

对于我们的期货 REST 和 WebSocket API (futures.kraken.com)，我们提供了一个使用 API URL demo-futures.kraken.com 的完整测试环境。

REST、WebSocket 和 FIX 测试环境

对于我们的现货 REST/WebSocket API 和 FIX API，我们目前为合格客户提供测试环境。访问此环境需要一个入职流程，您可以通过直接联系 API 团队来启动该流程。

使用 Validate 测试参数测试我们的 API

通过 REST API AddOrder 或 WebSocket API addOrder 端点下订单时，可以使用 validate 输入参数来模拟订单。

将 validate 参数设置为 true（validate=1、validate=true、validate=anything 等）调用 AddOrder/addOrder 将导致订单详情被检查是否存在错误，但 API 响应将永远不会包含订单 ID（在没有 validate 参数的情况下，成功订单始终会返回订单 ID）。

带有 validate 参数的 AddOrder 调用示例（请注意缺少的订单 ID）：

Bash

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}

小额真实订单和/或价格极端的订单

为了使用 Validate 参数进行全面的 API 测试，我们建议下达非常小的市价订单（最小订单量的订单），或价格远低于当前市场价格的限价订单（例如，当市场价格为 200 美元时，下达以 800 美元出售 ETH/USD 的限价订单）。

使用实时订单进行测试可以让您的 API 代码在真实世界条件下与我们的 API 交互，因此测试的各个方面都将是准确的（您的订单如何影响订单簿等）。

可能影响您的 API 连接的 TLS 升级

出于安全原因，我们最近已停止支持 TLS 1.0 和 1.1。如果您在尝试连接我们的 API 时遇到 SSL/TLS 连接错误消息，很可能是由于使用了这些已弃用标准之一。您需要修改您的 API 客户端以强制使用 TLS 1.2/1.3，或将您的 .NET 版本升级到 4.6 或更高版本，该版本默认使用 TLS 1.2/1.3。

REST API 身份验证计算器（Google 表格）

以下 Google 表格可用于计算任何输入数据组合的 REST API 身份验证签名：