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