Kraken Futures Api Python示例

Kraken Futures API允许交易者通过REST呼叫自动化期货交易，需要HMAC签名的请求，诸如`pi_xbtusd`之类的有效符号以及Kraken's Futures Tab中的单独的API键。

2025/07/26 19:29

什么是Kraken Futures API？

Kraken Futures API是一个基于REST的界面，可让交易者和开发人员与Kraken的期货交易平台进行编程互动。这包括下订单，检索市场数据，检查帐户余额和管理职位。它是算法交易者或建筑自动交易机器人的理想之选。要在Python中使用它，您必须首先从Kraken Futures帐户仪表板中获取API密钥和秘密。这些凭据必须牢固存储（可以在环境变量中，以避免将其暴露在代码中。

如何安装所需的Python库

在编写任何代码之前，请确保您安装了必要的库。如果您打算将环境变量用于API凭据，则最关键的是HTTP通信和python-dotenv的requests 。在终端中运行以下命令：

• pip install requests
• pip install python-dotenv
  

  安装后，您可以在脚本中导入它们：

   import os
   import requests
   import time
   import hashlib
   import hmac
   from dotenv import load_dotenv

  如果您使用.env文件存储凭据，请确保在脚本顶部调用load_dotenv() 。

  设置身份验证标头

  
  Kraken Futures API使用HMAC-SHA256签署请求。您必须为每个私人端点调用生成一个签名。该过程涉及：
• 创建一个nonce（在几秒钟内独特的时间戳）
• 串联请求路径，nonce和身体
• 使用您的API秘密来哈希

• 添加诸如APIKey和Authent （签名）之类的标题
  

  这是构建身份验证的方法：

   def get_kraken_signature(urlpath, data, secret):
   postdata = data
   encoded = (str(data['nonce']) + postdata).encode()
   message = urlpath.encode() + hashlib.sha256(encoded).digest()
   mac = hmac.new(base64.b64decode(secret), message, hashlib.sha512)
   sigdigest = base64.b64encode(mac.digest())
   return sigdigest.decode()

  此功能返回Authent Header值，这是私人API调用所需的，例如下订单或获取余额。

  通过API下达期货订单

  
  要下达期货订单，您必须向/derivatives/api/v3/sendorder端点发送POST请求。这是一个完整的示例：

   url = 'https://futures.kraken.com/derivatives/api/v3/sendorder' headers = { 'User-Agent': 'Python API Client', 'APIKey': os.getenv('KRAKEN_API_KEY'), }数据= {
  'ordertype'：'lmt'，
  “大小”：1，
  '符号'：'pi_xbtusd'，
  'side'：'买'，
  'limitprice'：'69000.0'，
  'cliorDid'：f'my order {int（time.time（）}'，
  'nonce'：str（int（time.time（） * 1000）），
  }
  
  
  
  
  
  
  
  签名= get_kraken_signature（'/sendorder'，data，os.getenv（'kraken_api_secret'））
  标题['authent'] =签名
  
  
  
  
  
  
  响应= requests.post（url，标头=标题，data = data）
  
  
  
  
  
  
  The **`cliOrdId`** ensures each order is unique. The **`symbol`** must match Kraken's futures contract naming convention (eg, `pi_xbtusd` for perpetual Bitcoin/USD).获取开放位置和帐户信息
  要检索您当前的打开位置，请将GET请求发送到`/derivatives/api/v3/openpositions'。不需要身体，但是您仍然需要身份验证：
   url ='https://futures.kraken.com/derivatives/api/v3/openpositions'
  标题= {
   'apikey'：os.getenv（'kraken_api_key'），
   “用户代理”：“ Python API客户端”，
   }
   nonce = str（int（time.time（） * 1000））
   data = {'nonce'：nonce}
  签名= get_kraken_signature（'/openpositions'，data，os.getEnv（'kraken_api_secret'））
  标题['authent'] =签名
   

响应= requests.get（url，标头=标题）
位置=响应。JSON（）

positions变量将包含活动位置的列表，包括进入价格，规模和未实现的损益。

常见错误以及如何修复它们

• 无效签名：双检查您的签名函数中的串联逻辑。确保nonce是一个字符串，并与数据有效载荷中的字符串匹配。
• 利润率不足：如果您的帐户缺少保证金，则可能会拒绝订单。首先使用/accountsummary检查您的余额。
• 无效符号：使用/instruments获取有效期货合约列表。不要假设命名模式。
• 费率限制：KRAKEN实施速率限制。如果您遇到429错误，请使用time.sleep(1)之间的请求之间添加一个延迟。
  

  常见问题

  我如何找到BTC/USD的正确期货符号？
  
  使用/instruments端点： GET https://futures.kraken.com/derivatives/api/v3/instruments 。寻找以usd结尾的符号 - 最常见的是永久期货合约的pi_xbtusd 。

  我可以将相同的API密钥用于现货和期货交易吗？
  
  否。KrakenFutures需要从您的Kraken帐户中的“期货”选项卡生成的单独的API密钥。使用点键将返回身份验证错误。

  为什么即使使用正确的参数也会拒绝我的订单？
  
  检查您的订单大小是否低于最小值（例如，BTC/USD的0.001 BTC）。还可以验证limitPrice与商标价格的偏差范围内 - Kraken可能拒绝订单距离当前市场太远。

  在环境变量中存储API键安全吗？
  
  是的，只要您的.env文件不致力于公共存储库即可。始终将.env添加到.gitignore文件中，并且切勿在代码中打印或记录API键。