如何從Kraken API獲取歷史合同數據？

通過'Futures-api.kraken.com/api/history/Candles“使用符號，間隔和UNIX時間戳獲取Kraken Futures歷史OHLC數據；如果限制速率，則使用API鍵和HMAC-SHA256簽名進行身份驗證。

2025/08/08 14:49

了解Kraken API和歷史合同數據

Kraken API是一個強大的接口，使開發人員和交易者能夠以編程方式與Kraken的加密貨幣交換服務進行交互。在參考歷史合同數據時，重要的是要澄清Kraken主要通過其Kraken Futures Platform（以前稱為Cryptowatch衍生品）來支持現貨交易和期貨合約。標準Kraken REST API（API.KRAKEN.COM）不直接提供期貨或永久合同的歷史數據。取而代之的是，可以通過Futures-api.kraken.com託管的Kraken Futures API訪問歷史合同數據。

要檢索歷史數據，您必鬚根據所需的合同和時間範圍的類型確定正確的端點。 Kraken Futures API提供諸如/api/history/candles等終點，以獲取特定期貨合約的OHLC（開放，高，低，關閉）數據。每個端點都需要參數，例如符號，間隔和從/直到時間戳來定義數據范圍。

設置API訪問憑據

在提出任何請求之前，您必須設置對Kraken Futures API的經過身份驗證的訪問。這涉及創建一個API密鑰和秘密：

• 登錄到您的Kraken帳戶並導航到資金部分。
• 選擇API並選擇Kraken Futures 。
• 單擊創建API鍵。
• 分配許可證 - 啟用讀取訪問的市場數據。
• 生成密鑰，並安全地存儲API密鑰和秘密密鑰。

這些憑據必須使用HMAC-SHA256簽署請求。與現貨交易不同，Kraken Futures使用單獨的身份驗證機制。每個請求都必須包括諸如APIKey和Authent標題，在該Authent中，根據請求方法，路徑，車身和時間戳是計算的簽名。

構建API的歷史數據請求

要檢索歷史合同數據，請使用蠟燭歷史終點：

 GET https://futures-api.kraken.com/api/history/candles

所需的查詢參數包括：

• 符號：合同符號，例如Bitcoin永久逆同合同的PI_XBTUSD 。
• 間隔：燭台間隔。有效值包括1m ， 5m ， 15m ， 1h ， 4h ， 1d 。
• 來自：在UNIX時間戳（秒）中開始時間。
• 直到：unix時間戳中的結束時間（秒）。

例如，從2024年1月1日至2024年1月2日，以獲取Bitcoin永久合同的1小時蠟燭：

 https://futures-api.kraken.com/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600

如果僅訪問公共市場數據，則此請求不需要身份驗證。但是，如果限制限制，請考慮使用身份驗證的請求。

處理限制要求的身份驗證

如果您超過了未經身份驗證的請求限制，請切換到簽名的請求。該過程涉及：

• 使用方法，路徑，車身和ISO 8601時間戳創建請求有效負載。
• 將時間戳，方法，路徑和身體（如果存在）連接到簽名字符串中。
• 將HMAC-SHA256與您的秘密鍵一起生成簽名。
• 包括Authent標頭中的簽名和APIKey中的鑰匙。

python中的示例步驟：

• 設置請求方法： GET
• 定義路徑： /api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• 生成ISO時間戳： 2024-01-01T00:00:00Z
• 構建簽名消息： 2024-01-01T00:00:00ZGET/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• 使用您的秘密密鑰計算消息的HMAC-SHA256
• 編碼base64中的結果
• 設置標題：
  • APIKey: YOUR_PUBLIC_KEY
  • Authent: BASE64_SIGNATURE
  • Nonce: 2024-01-01T00:00:00Z

使用庫之類的requests發送請求。

處理和存儲響應數據

API返回包含蠟燭對像數組的JSON響應。每個蠟燭都包括：

• 時間戳：蠟燭的時間開始。
• 開放：開頭。
• 高：最高價格。
• 低：最低的價格。
• 關閉：收盤價。
• 數量：交易數量。

示例響應：

 {
 'result': 'success',
 'candles': [ { 'timestamp': 1704067200, 'open': '42000.00', 'high': '42500.00', 'low': '41800.00', 'close': '42300.00', 'volume': '120.5' }

這是給出的
}

解析JSON並提取candles陣列。您可以將此數據存儲在CSV，數據庫或數據框架中以進行分析。確保根據需要將時間戳轉換為本地時間或UTC。如果時間範圍很大，則處理分頁 - Kraken可能會限制每個請求的結果，需要多次from和until值調整為止。

常見錯誤和故障排除

• 無效符號：雙檢查合同符號。使用GET /api/instruments列出所有可用合同。
• 利率限制：未經身份驗證的請求受到限制。使用身份驗證或在呼叫之間添加延遲。
• 無效時間戳格式：確保UNIX時間戳為幾秒鐘，而不是毫秒。
• 簽名不匹配：驗證簽名字符串包含確切的路徑和查詢參數，並且秘密鍵是正確的。
• 空響應：確認時間範圍包括主動交易期。

使用Postman或Python腳本等工具來逐步測試請求。啟用記錄以捕獲請求標題和調試的響應。

常見問題

如何找到Kraken Futures合同的正確符號？

使用儀器端點： GET https://futures-api.kraken.com/api/instruments 。這將返回所有具有其符號的活動合同，例如Bitcoin perpetuals的PI_XBTUSD或以太期貨的FI_ETHUSD 。

我可以檢索刻度級的歷史數據而不是蠟燭嗎？

Kraken Futures API不會通過公共端點提供tick級數據。 /api/history/candles端點僅在指定的間隔內支持匯總的OHLC數據。對於顆粒數據，請考慮Websocket Feeds或第三方數據提供商。

我一次可以獲取多少歷史數據有限制嗎？

是的，API可能會限制每個請求返回的蠟燭數量。如果您的時間範圍很大，則將其分為較小的間隔（例如一次），然後提出多個請求。檢查響應的完整性，並from和until參數相應地調整。

我需要成為經過驗證的Kraken用戶才能訪問歷史合同數據嗎？

對於未經驗證的公共數據請求，基本帳戶訪問就足夠了。但是，為了提高利率限制並確保穩定訪問，建議使用API憑據的驗證帳戶。數據檢索不需要完整的交易許可。