如何创建现货API密钥

Last updated: 2025年8月8日

API密钥是 API 认证与安全体系的核心组件，其作用相当于您Kraken帐户的用户名和密码。

调用任何账户特定（私有）API 端点（例如账户数据、交易、资金和收益端点）需要API密钥。调用市场数据（公共）API 端点不需要API密钥，因为市场数据端点不与任何特定的Kraken帐户关联。

任何与我们的市场和账户交互的软件都可以使用API密钥，例如我们的 REST API 命令行客户端、第三方移动应用和交易平台、第三方交易机器人以及各种其他产品/服务。

API密钥包含多项必须配置的设置和选项方可使用，特别是名称/描述与访问权限。

密钥说明

密钥描述本质上是API密钥的名称，几乎可以是您喜欢的任何内容，只要该描述是唯一的（与同一账户上任何其他API密钥的描述不同）即可。

默认情况下，密钥描述将填充为类似“api-key-1605316109249“的内容。您可以选择保留此默认描述，也可将其更改为更具描述性的名称（例如“交易密钥“、“账户管理密钥“、“Python API密钥 6“ 或 “移动应用密钥“等）。

密钥权限

密钥权限决定API密钥被允许调用哪些账户特定（私有）API 端点：

•
查询分类账条目权限是 API 端点所必需的，这些端点用于从账户账簿中检索历史账户数据，即分类帐和查询分类帐。
•
导出数据权限是导出（下载）账户分类帐的端点所必需的，即添加导出任务、检索导出数据、导出状态和移除导出任务。
•
访问 WebSockets API 权限是必需的，以便通过获取 WebSockets 令牌端点检索用于 WebSockets API 的认证令牌。

作为正确使用API密钥权限的示例，假设您需要向第三方提供一个仅用于交易目的的API密钥。此类API密钥肯定需要修改订单和取消/关闭订单权限，可能需要查询未结订单和交易权限，但几乎肯定不需要提取资金权限。

合理配置权限将允许 API 客户端为该账户进行交易，但将阻止 API 客户端访问任何账户信息或执行资金任务。

可选设置

剩余的API密钥设置仅是用于更高级的配置，因此通常可以保持其默认值：

•
随机数窗口是一项用于解决网络问题的设置，这些问题可能导致 API 请求乱序到达。该设置通过提供一个短暂时间范围（1 秒、10 秒等），在此时间内，即使收到无效 nonce API 请求（即 Nonce 值低于先前使用过的 Nonce 值），也不会触发无效 Nonce 错误。
•
IP 白名单是一项安全功能，它将API密钥的使用限制在特定的客户端 IP 地址范围内。
•
密钥过期可用于创建一个只在特定时间段内有效的API密钥，例如一个仅在 1 周内有效的密钥。
•
查询开始/结束日期/时间是一个设置，用于将历史账户数据请求限制在特定时间范围内，例如，一个可以检索今年交易历史但不能检索任何往年历史的密钥。