如何通过 Python 使用 Kraken Futures API？ （开发者指南）

设置身份验证凭据

1. 登录您的 Kraken 帐户并导航至 API 下的“设置”部分。

2. 生成专门用于期货交易的新 API 密钥对，确保启用“期货”权限。

3. 安全地存储 API 密钥和私钥 — 切勿将它们硬编码到源文件中或将其提交给版本控制。

4. 使用KRAKEN_FUTURES_API_KEY和KRAKEN_FUTURES_PRIVATE_KEY等环境变量在运行时注入凭据。

5. 通过发出最小的身份验证请求来验证密钥，例如通过GET /api/v3/accounts端点获取帐户余额。

安装和配置所需的库

1. 使用 pip 安装官方 Kraken Futures Python SDK： pip install kraken-futures-api 。

2. 或者，如果需要对标头和签名逻辑进行细粒度控制，则可以直接使用请求。

3. 导入必要的模块： KrakenFuturesAPI 、 json 、 base64 ，用于手动生成签名。

4. 使用您的凭据初始化客户端： client = KrakenFuturesAPI(key=key, Secret=secret) 。

5. 通过调用client.get_server_time()并验证响应包含有效的 Unix 时间戳来确认连接。

下达和管理期货订单

1. 构建指定交易品种（例如PI_XBTUSD ）、边（买入或卖出）、大小和订单类型（限价、市价、止损）的订单有效负载。

2. 使用client.send_order(...)提交订单，该命令返回包含order_id 、 status和filled_size 的结构化响应。

3. 使用client.cancel_order(order_id)取消活动订单并在返回的 JSON 中验证取消状态。

4. 使用client.get_open_orders()检索未结订单，必要时按交易品种或订单 ID 进行过滤。

5. 通过轮询client.get_fills()或与 Kraken 的 WebSocket feed 集成来监控执行事件的实时填充。

处理保证金和头寸数据

1. 使用client.get_margin_requirements(symbol='PI_XBTUSD')获取每个合约的当前保证金要求。

2. 通过client.get_open_positions()查询未平仓头寸，检查size 、 mark_price和unrealized_pnl等字段。

3. 使用client.set_leverage(symbol='PI_XBTUSD', lever=5)调整仓位杠杆，并遵守 Kraken 的分级保证金规则。

4. 通过提交与当前规模相匹配的相反市价单明确平仓，或使用client.close_position(symbol='PI_XBTUSD') 。

5. 解析client.get_account_summary()中的强平风险指标，特别是margin_level和available_margin 。

常见问题解答

问：我可以对现货和期货端点使用相同的 API 密钥吗？答：不需要。Kraken 需要单独的 API 密钥来用于现货和期货服务。在 Spot API 设置下生成的密钥缺乏 Futures 权限，并将在 Futures 端点上返回 HTTP 403。

问：如果我的订单签名过期会怎样？答：Kraken 对签名请求强制执行 60 秒的有效窗口。如果Kraken-Api-Key标头中的时间戳与服务器时间相差超过 60 秒，请求将失败并显示错误代码EAPI:Invalid nonce 。

问：如何解释订单响应中的状态字段？答：有效值包括accepted 、 triggered 、 canceled 、 filled和expired 。每个都反映了受价格条件和系统处理控制的不同生命周期阶段。

问：Futures API 有速率限制吗？答：是的。 Kraken 根据帐户层和端点类别应用动态速率限制。超出限制将返回 HTTP 429，并包含指示延迟持续时间（以秒为单位）的 Retry-After标头。