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鍵。