Kraken Futures API教程

了解Kraken Futures和API生态系统

Kraken Futures API是一种强大的工具，专为寻求自动访问Kraken衍生品市场的贸易商和开发商而设计。与现货交易不同，期货允许用户使用杠杆推测加密货币的价格变动。 KRAKEN FUTURES API提供了以编程方式下订单，检索市场数据，管理职位和监视帐户状态的终点。该API通过HTTPS和WebSocket协议运行，允许基于REST的请求和数据的实时流传输。

要与API互动，您必须首先了解其两个主要环境： futures.kraken.com上的生产环境和demo-futures.kraken.com上的沙盒测试环境。沙箱使开发人员能够在不冒险的情况下测试策略。所有端点都需要使用API密钥和秘密进行身份验证，这些端口是通过您的Kraken Futures帐户仪表板生成的。

私人端点的每个请求必须包括三个标题：

• Apikey ：您的公共API密钥
• 身份验证：从您的秘密钥匙生成的SHA256 HMAC签名
• NONCE ：独特的，增量的数字或时间戳

这些安全措施确保只有授权用户才能执行诸如下订单或撤回资金之类的措施。

设置您的Kraken Futures API凭据

在进行任何API调用之前，您必须在Kraken Futures帐户中生成有效的凭据。导航到您的Kraken Futures仪表板中的API管理部分。确保您登录正确的环境，无论是现场还是演示，都可以根据自己的开发需求来登录。

• 单击“生成新键”
• 将描述性名称分配给您的API键，以更轻松地标识
• 选择适当的权限：订单放置，阅读余额和观看位置
• 启用IP白名单（如果需要）
• 确认发电过程

完成后，您将收到两个关键组件： API键（一个长字母字符串）和私人秘密。安全地存储这些。关闭对话框后，秘密将不会再次显示。失去它意味着您需要撤销和再生钥匙。

出于测试目的，请使用沙箱环境避免在现场市场上进行意外交易。在环境之间切换时，请相应地更新您的基本网址：

• 沙盒： https://demo-futures.kraken.com
• 直播： https://futures.kraken.com

私人终点的身份验证机制

访问/orders ， /positions或/account之类的私人端点需要适当的身份验证。该过程的核心在于生成有效的HMAC-SHA256签名。此签名来自您的私人秘密，包括请求路径，NONCE和身体（如果适用）。

这是逐步构建身份验证标头的方法：

• 加入当前的UNIX时间戳（如NONCE），请求路径（例如/api/v3/leads/status ），并将请求正文（如果发布/put）纳入一个字符串
• 使用您的私人秘密计算此串联的hmac-sha256哈希
• 用base64格式编码产生的哈希
• 在Authentification标头中包括此编码值

Python示例：

 import hmac import hashlib import time nonce = str（int（time.time（） * 1000））路径='/api/v3/orders' body ='{'ordertype'：'lmt'，'符号'：'pi_xbtusd'，'side'：'buy'，'size'：1000，'limitprice'：30000}'






消息= nonce +路径 +身体签名= hmac.new（






b'your_private_secret_here', msg=message.encode(), digestmod=hashlib.sha256
 ）。消化（）
 
auth_header = base64.b64encode（签名）.decode（）

该签名以及APIKey和Nonce必须包含在每个私人请求中。

通过API下达期货订单

经过身份验证后，您可以开始与交易端点进行交互。要下订单，请将邮政请求发送到/api/v3/sendorder 。有效负载必须包括基本参数，例如符号，侧面，大小和订单类型。

JSON主体中所需的字段：

• OrderType ：可以是lmt （限制）， mkt （市场）或post （仅限后限制）
• 符号：例如，永久Bitcoin/USD合同的pi_xbtusd
• 侧面sell buy
• 尺寸：合同数（大多数对1至少1）
• 限额：限额订单所必需的

使用卷曲的示例请求：

 curl -X POST https://futures.kraken.com/api/v3/sendorder \ -H 'APIKey: your_api_key_here' \ -H 'Nonce: 1234567890' \ -H 'Authentification: generated_signature_here' \ -d '{'orderType':'lmt','symbol':'pi_xbtusd','side':'buy','size':100,'limitPrice':35000}'

提交后，API返回包含orderId ，状态和其他元数据的响应。您可以使用此ID来取消或查询订单。

检索市场数据和帐户信息

公共终点不需要身份验证，并且是获取实时市场条件的理想选择。有用的终点包括：

• GET /api/v3/tickers ：返回所有符号的最新价格，筹资率和开放利息
• GET /api/v3/orderbook?symbol=pi_xbtusd ：获取完整级别2订单书
• GET /api/v3/history?symbol=pi_xbtusd&lastTime=... ：检索最近的贸易历史记录

对于特定于帐户的数据，请使用私人端点：

• GET /api/v3/accounts ：在所有分类帐中显示保证金余额，权益和pnl
• GET /api/v3/positions ：列出所有具有入口价格，规模和清算水平的活跃位置
• GET /api/v3/orders ：检索打开订单；添加?order_status=closed以查看填充/取消的

所有响应均采用JSON格式，使其易于在代码中解析。投票间隔应尊重利率限制 - 公共终点的每秒10个请求，私人终点为5个请求。

处理错误并调试API电话

即使使用正确的语法，API请求也可能由于无效的参数，保证金不足或连接性问题而失败。常见的HTTP状态代码包括：

• 400不良要求：畸形的JSON或缺少所需字段
• 401未经授权：无效的API键或失败的签名验证
• 403禁止：IP不列出白色或不足的权限
• 429太多请求：费率限制超过

错误响应包含code和error消息。例如， 'error': 'Invalid signature'表示HMAC计算中的不匹配。仔细检查串联逻辑和编码步骤。

在开发过程中启用原始请求和响应的记录。诸如Postman或带有-v标志的工具可以帮助检查标头和有效载荷。验证时间戳 - 它们必须在Kraken服务器时间的小窗口（通常是±60秒）内，可以通过GET /api/v3/time检索。

我如何找到期货合约的正确符号？符号遵循特定的命名约定。永久性从pi_开始，然后是基本和报价货币（例如， pi_ethusd ）。季度期货使用f_前缀，包括到期日期（例如f_xbtusd_240628 ）。检查/api/v3/instruments以获取完整列表。

我可以在现场和期货交易中使用相同的API密钥吗？否。KrakenSpot和Futures平台在单独的系统上运行。您必须从Kraken Futures仪表板中生成不同的API键，而不是主Kraken.com界面。

Kraken Futures的最低订单规模是多少？大多数永久合同的最低订单大小为1合同。一份合同通常等于基础资产的$ 1。对于pi_xbtusd ，1合同= $ 1的Bitcoin。始终通过/api/v3/instruments验证。

Websocket是否可用于Kraken Futures？是的。连接到wss://futures.kraken.com/ws/v1以获取有关订单，交易和您的私人订单活动的实时更新。身份验证涉及发送从/api/v3/auth/token端点获得的token 。