如何在 Kraken Pro 上建立 API 金鑰

上次更新時間: 2025年3月31日

API 金鑰是 API 驗證的主要組成部分之一;它們相當於您 Kraken 帳戶的用戶名和密碼的 API 版本。

API 金鑰是呼叫任何帳戶特定(即私人)API 端點所必需的,包括帳戶管理交易資金賺取端點。呼叫市場數據(即公共)API 端點不需要 API 金鑰,因為市場數據端點不與任何特定的 Kraken 帳戶相關聯。

API 金鑰可供任何與我們的市場和帳戶互動的軟件使用,例如我們的REST API 命令列客戶端、一些流動應用程式、第三方交易機器人以及許多其他產品/服務。

建立 API 金鑰

Settings

  • 前往API分頁,然後點擊「建立 API 金鑰」(您將在後續步驟中設定您的 API 金鑰)

Create API Key

設定 API 金鑰

API 金鑰有幾個設定和選項,必須在使用前進行配置,特別是名稱/描述和存取權限。

Form

金鑰名稱

金鑰名稱本質上就是 API 金鑰的名稱,可以是您喜歡的任何名稱,只要描述是獨一無二的(與同一帳戶上任何其他 API 金鑰的描述不同)。

最佳做法是為您的 API 金鑰提供一個描述性名稱,而不要洩露敏感資訊。(例如「交易金鑰」、「帳戶管理金鑰」、「Python API 金鑰 6」或「流動應用程式金鑰」)。

金鑰權限

金鑰權限決定了 API 金鑰可以呼叫哪些帳戶特定(私人)API 端點:

資金

  • 查詢資金是查詢帳戶餘額資訊的 API 端點所必需的,例如餘額交易餘額

  • 存入資金是與存款相關的資金端點所必需的,例如存款方式存款地址

  • 提取資金是與提款相關的資金端點所必需的,例如提款資訊提款取消提款

訂單與交易

  • 查詢未結訂單與交易是查詢現有訂單和保證金倉位的 API 端點所必需的,例如未結訂單查詢訂單未結倉位

  • 查詢已結訂單與交易是查詢先前已結/已取消訂單和保證金倉位的端點所必需的,例如已結訂單查詢訂單查詢交易

  • 修改訂單是下達新訂單的交易端點所必需的,例如新增訂單編輯訂單批量新增訂單

  • 取消/平倉訂單是取消未結或待處理訂單的交易端點所必需的,例如取消訂單全部取消批量取消訂單

數據

  • 查詢分類帳條目是從帳戶分類帳中檢索歷史帳戶數據的 API 端點所必需的,即分類帳查詢分類帳

  • 匯出數據是匯出(下載)帳戶分類帳的端點所必需的,即新增匯出檢索匯出匯出狀態移除匯出

作為正確使用 API 金鑰權限的範例,請考慮為第三方交易目的提供的 API 金鑰。此類 API 金鑰肯定需要修改訂單取消/平倉訂單權限,可能需要查詢未結訂單與交易權限,但幾乎肯定不需要提取資金權限。

適當地配置權限將允許 API 客戶端為帳戶進行交易,但會阻止 API 客戶端存取任何帳戶資訊或執行資金任務。

可選設定

其餘的 API 金鑰設定僅適用於更進階的配置,因此通常可以保留其預設值:

  • WebSocket 介面是透過GetWebSocketsToken端點檢索 WebSocket API 驗證令牌所必需的。

  • IP 位址限制是一項安全功能,可將 API 金鑰的使用限制為特定的客戶端 IP 位址。

  • 金鑰到期可用於建立僅在特定時間內有效的 API 金鑰,例如僅有效 1 週的金鑰。

  • 查詢開始/結束日期/時間是一項設定,用於將歷史帳戶數據請求限制在特定時間範圍內,例如,某個金鑰可以檢索今年的交易歷史,但不能檢索往年的交易歷史。

  • 自訂 Nonce 視窗是一項設定,用於解決可能導致 API 請求亂序到達的網絡問題,透過提供一個短時間範圍(例如 1 秒、10 秒等),在此期間,nonce 無效(nonce 值低於先前使用的 nonce 值)的 API 請求不會導致無效 nonce 錯誤。

設定好 API 金鑰後,點擊「產生金鑰」按鈕即可建立新的 API 金鑰。

使用 API 金鑰

API 金鑰由一對公開金鑰和私密金鑰組成,兩者都必須提供給 API 用戶端軟體。

Added key

API 金鑰可以透過不同方式提供,例如:

  • 金鑰對可以直接以純文字形式複製並貼上到 API 用戶端程式碼中。範例:我們的 PHP API 用戶端所使用的方法。

  • 金鑰對可以複製並貼上到 API 用戶端可以存取的純文字檔案中。範例:我們的 命令列 API 用戶端所使用的方法。

注意:私密金鑰在某些 API 用戶端軟體中也稱為 API secret(或簡稱為 secret)。

API 金鑰的 2FA

API 金鑰已提供安全的方式來驗證 Kraken 帳戶的 API 存取,但透過新增雙重認證 (2FA) 可以進一步增強其安全性。

API 金鑰 2FA 可以透過「安全」頁面新增至現有的 API 金鑰,並且可以使用靜態密碼或 Google Authenticator。

注意:為 API 金鑰新增 2FA 也要求 API 用戶端支援 2FA(為每次呼叫私密 API 方法提供 2FA 數據),否則將會傳回意外錯誤,而非預期的 API 輸出。

在此處閱讀更多關於 API 金鑰 2FA 運作方式的資訊這裡

需要更多幫助?