如何通過 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標頭。