如何使用Kraken API

了解Kraken API及其目的

Kraken API是一個強大的工具，可讓開發人員和交易者以編程方式與Kraken CryptoCurrency Exchange進行交互。它可以自動交易，投資組合管理，實時市場數據檢索和帳戶監視，而無需依賴Web界面。 API支持兩個公共終點，它們提供了市場數據，例如股票信息，訂單簿和貿易歷史記錄以及需要身份驗證的私人端點，並允許用戶管理訂單，檢查餘額和撤回資金。

要有效地使用Kraken API，您必須了解其兩個主要組件： REST API和WebSockets API 。 REST API非常適合一次性請求，例如獲取資產價格或下訂單。 Websockets API用於實時數據流，例如實時價格更新或訂單簿更改。這兩個API分別均可通過HTTPS和WebSocket連接訪問，並且通常需要以JSON格式使用請求和響應的正確格式。

設置您的Kraken API憑據

在進行任何API調用之前，您需要從Kraken帳戶中生成API密鑰和秘密。登錄到您的Kraken帳戶並導航到設置部分。單擊“ API”選項卡，然後選擇新的API鍵。將提示您為密鑰設置權限。有關基本數據檢索，請啟用查詢公共和查詢私人選項。如果您打算進行交易或撤回資金，還可以啟用貿易和撤回權限。謹慎對待權限，因為受損的鑰匙可能會導致基金損失。

生成鑰匙後，您將看到兩個字符串：

• API鍵：用於標識您帳戶的長字母數字字符串。
• API秘密：用於簽名請求的基本64編碼字符串。

安全地存儲這些。不應在客戶端代碼或公共存儲庫中暴露API秘密。要在API請求中使用這些憑據，您必須使用HMAC-SHA512加密簽署每個私人請求，而API Secret作為密鑰和包含URI路徑，NONCE和POST數據的消息。

執行公共API請求

公共端點不需要身份驗證，可以通過HTTP獲取請求直接訪問。這些對於檢索市場數據很有用。例如，要使用美元（BTC/USD）獲取Bitcoin的當前股票信息，請使用以下端點：

 https://api.kraken.com/0/public/Ticker?pair=XXBTZUSD

響應將包括最後交易價格， 24小時的數量，高/低價和出價/詢問率。其他公共終點包括：

• 資產：列出所有可交易對及其規格。
• 深度：返回給定對的當前訂單書。
• 貿易：檢索最近的貿易歷史。
• OHLC ：提供用於圖表的燭台數據。

每個公共請求都返回一個帶有result字段的JSON對象，其中包含數據和error字段列出任何問題。通過在處理結果之前檢查error陣列，確保您的應用程序可以優雅地處理錯誤。

簽署和發送私人API請求

私有API調用需要使用API鍵和加密簽名進行身份驗證。每個請求都必須包括以下標題：

• API-Key ：您生成的API密鑰。
• API-Sign ：消息的HMAC-SHA512簽名。

要簽署的消息包括：

• URI路徑（例如， /0/private/Balance ）。
• 一個非CE值 - 嚴格增加的整數一次。
• 帖子數據（例如， nonce=1234567890 ）。

構建簽名：

• 將消息串聯爲： path + SHA256(nonce + POST data) 。
• 使用解碼的API秘密作為HMAC鍵。
• 將HMAC-SHA512應用於串聯消息。

在Python中，可以將其實施為：

 import hashlib import hmac import time def get_kraken_signature（urlpath，數據，秘密）：



postdata = urllib.parse.urlencode(data) encoded = (str(data['nonce']) + postdata).encode() message = urlpath.encode() + hashlib.sha256(encoded).digest() mac = hmac.new(base64.b64decode(secret), message, hashlib.sha512) return base64.b64encode(mac.digest()).decode()
在向API-Sign提出帖子請求時，請在/0/private/Balance或/0/private/AddOrder中使用此簽名。
 
實際用例和代碼示例
常見用例是檢查您的帳戶餘額。為此：
 

• 將發布請求發送到https://api.kraken.com/0/private/Balance 。
• 將nonce包括在郵局中。
• 設置API-Key和API-Sign標題。

另一個例子是下達限額購買訂單：

• 使用/0/private/AddOrder端點。
• 包括參數，例如pair=XXBTZUSD ， type=buy ， ordertype=limit ， price=30000和volume=0.01 。
• 確保NUNCE大於前一個。

對於實時數據，請使用Websockets API。連接到wss://ws.kraken.com/v2 。訂閱諸如ticker ， book或trade之類的渠道。例如，要實時BTC/USD交易：

{

“方法”：“訂閱”， 'params'：{

'channel': 'trade', 'symbol': 'BTC/USD', 'snapshot': true

} }

服務器將在發生交易更新。使用應用程序中的事件偵聽器處理傳入消息。

安全最佳實踐和限制費率

Kraken強加了限制限制以防止濫用。公共端點每秒最多允許10個請求。私人端點每秒限制為每秒15個請求。超過這些限制會導致暫時禁令。為了避免這種情況，請在代碼中實現請求限制和指數向退縮。

通過：

• 將IP白色列入用於API鍵。
• 禁用不必要的許可。
• 定期旋轉API鍵。
• 切勿以明文來記錄或存儲API秘密。

始終將HTTP用於Websocket的REST調用和WSS 。在生產環境中驗證SSL證書。

常見問題

Kraken API請求中NONCE的正確格式是什麼？ nonce必須是一個隨著每個請求而增加的整數。大多數開發人員在微秒中使用UNIX時間戳。例如，python中的int(time.time() * 1000000)確保獨特性和單調增長。重複使用或減少NONCE會導致API拒絕請求。

如何在不冒險的實際資金冒險的情況下測試Kraken API？ Kraken不提供沙盒環境。但是，您可以創建一個新的API密鑰，而無需取消或交易權限，並使用它來測試餘額查詢和市場數據檢索。用於交易模擬，獲取市場數據並在本地模擬訂單執行，而無需發送真實訂單。

為什麼我會得到“ EAPI：無效的密鑰”錯誤？此錯誤表明API-KEY標頭丟失，畸形或未識別。仔細檢查鍵是否已從Kraken儀表板中精確複製並包含在請求標題中。另外，確保不存在額外的空間或線路斷路。

我可以使用Kraken API檢索歷史燭台數據嗎？是的。使用/0/public/OHLC端點，帶有pair和interval參數。例如， pair=XXBTZUSD&interval=60返回1小時的蠟燭。響應包括時間，開放，高，低，關閉和音量數據。請注意，Kraken將歷史數據限制為每個請求的一定數量的近期間隔。