唯讀 API 金鑰:在 Kraken、Coinbase 與 OKX 上該勾選的權限

唯讀 API 金鑰讓應用程式能查看您的帳戶,卻無法交易或出金。本文列出 Kraken、Kraken Futures、Coinbase 與 OKX 上的確切權限,以及依 IP 位址限制金鑰的方式。

唯讀 API 金鑰是存取您在某個平台上帳戶的金鑰,可以查詢您的餘額、委託與歷史紀錄,但無法下單、轉帳或出金。

為什麼金鑰的權限很重要

追蹤您投資組合的應用程式會保存您的金鑰,以代您呼叫平台。如果金鑰外洩,外洩的就是它的權限,而且只限於這些權限。Coinbase 針對其 Transfer 權限提出警告:取得這類金鑰 Secret 的人,可以把您所有的加密貨幣轉出帳戶。唯讀金鑰只會顯示您自己看得到的內容。

各平台的權限

平台應授予的權限應拒絕的權限
KrakenQuery Funds、Query Open Orders & Trades、Query Closed Orders & Trades、Query Ledger Entries、Export Data入金、出金,以及任何建立、修改或取消委託的權限
Kraken FuturesGeneral API 唯讀General API 完整存取、Withdrawal API 完整存取
CoinbaseViewTrade、Transfer
OKXReadTrade、Withdraw

各項權限的作用

  • Kraken:查詢類權限讀取資金、未成交與已關閉的委託、帳本以及匯出資料;入金、出金與委託類權限則會對帳戶進行操作。
  • Kraken Futures:另一組獨立的金鑰。唯讀模式下,它只開放不會在伺服器上寫入任何內容的端點。完整存取會讓它成為一組主金鑰,而出金取決於另一項獨立的權限,也就是 Withdrawal API。
  • Coinbase:View 用於查看帳戶,Trade 用於下單,Transfer 用於轉出資金。
  • OKX:Read 用於查看帳戶及其歷史紀錄;Trade 用於下單與撤單、劃轉資金以及變更設定;Withdraw 用於出金。

把金鑰限制在一個 IP 位址上

金鑰也可以限制為只能從特定 IP 位址使用:如果呼叫來自其他地方,即使 Secret 正確,平台也會拒絕它。

  • Kraken 為每組金鑰提供允許的 IP 位址清單與到期日。
  • Coinbase 建議使用其 IP 白名單,但不強制。
  • OKX 每組金鑰最多可綁定 20 個 IP 位址。可以交易或出金、卻沒有綁定 IP 位址的金鑰,在 14 天未使用後會失效。

Hyperliquid:完全不需要金鑰

Hyperliquid 的 info 端點可以查詢任何地址,地址以明文寫在請求中:要追蹤一個帳戶,有它的地址就夠了。Hyperliquid 特別說明,要提供帳戶本身的地址,而不是 API 錢包的地址,後者會傳回空的結果。

事後檢查金鑰

  • 重新檢視權限:平台的 API 頁面會顯示每組金鑰的權限。
  • 刪除不再使用的金鑰:已刪除的金鑰再也無法使用,即使其 Secret 已經外洩。
  • 替換您有疑慮的金鑰:先建立新金鑰,把它填入應用程式,確認可以運作後,再刪除舊金鑰。

CentraFIN 如何處理您的金鑰

  • 保存前先檢查:CentraFIN 會向 Coinbase 與 OKX 查詢新金鑰的權限,如果它能交易、轉帳或出金,就會拒絕。Kraken 不支援這種檢查:新增視窗會列出需要勾選的權限。
  • 加密:金鑰及其 Secret 一送達就會加密(AES-256-GCM),之後不會再顯示。
  • 單一位址:呼叫都從我們的中繼伺服器 130.110.240.91 送出,這就是您需要在金鑰上允許的位址。

各平台的逐步說明:Kraken、Kraken Futures、Coinbase、OKX 與 Hyperliquid。

來源

常見問題

唯讀金鑰會把我的帳戶清空嗎?

不會。它既不能下單,也不能轉帳或出金。不過,持有它的人看得到您的餘額與歷史紀錄。

每個應用程式都要用一組獨立的金鑰嗎?

最好如此:這樣您就能刪除其中一組,而不影響其他金鑰。

為什麼要把金鑰限制在一個 IP 位址上?

因為被盜的金鑰在別處就無法使用:任何不是來自允許位址的呼叫,平台都會拒絕。

CentraFIN 用我的金鑰能看到什麼?

金鑰允許查詢的內容:餘額、持倉、委託、成交紀錄與轉帳。僅此而已,因為它無法做其他任何事。

掌握您的資產

一分鐘即可建立帳戶,不需密碼。