KuCoin API Key 申請教學:唯讀權限設定完整步驟(2026)
發布於 2026年7月17日
KuCoin 的資產想跟其他交易所一起看總額,申請一把唯讀 API Key 即可:App 只能讀取,下單、提幣請求都會被 KuCoin 伺服器擋掉,金鑰外流也動不了錢(原理見唯讀 API Key 安全嗎?)。
KuCoin 跟 OKX、Bitget 一樣是「三件套」交易所:除了 Key 和 Secret,還要一組自訂的 API Passphrase。
還沒有 KuCoin 帳號?先到 KuCoin 官方註冊頁完成註冊。
申請步驟(手機 App)
以下用 KuCoin App 示範。若用網頁版,流程相同:登入後進入「API 管理」(直接開啟),一樣建立 API-Based Trading 金鑰、只留 General 讀取權限即可。
第一步:點左上角頭像
登入 KuCoin App,在首頁點左上角的頭像,展開帳戶選單。

第二步:在「More」區找到「API」
往下捲到「More」區塊,點「API」。

第三步:點「Create API」
進入「API Management」頁面,點右上角的「Create API」開始建立金鑰。

第四步:選 API-Based Trading、設定名稱與 Passphrase、只勾 General
在建立表單頂端選「API-Based Trading」分頁(不是「Link Third-Party Apps」),然後:
- API Name:輸入好認的名字(例如
Exagg demo)。 - API Passphrase:自己設定一組短語。這是 KuCoin 特有的第三樣——API 呼叫都要用到它,忘了就得整把金鑰刪掉重建,務必記下來。
- API Restrictions:只留「General」(它預設就已勾選,說明寫著「For read-only access… Order placement and withdrawals are not allowed.」唯讀、不能下單提現)。「Spot Trading」「Margin Trading」「KuCoin Earn」這些交易類權限全部不要勾。

第五步:IP 選項後按「Next」並完成驗證
往下捲到 IP 設定:想更保險可選「Restrict to Trusted IPs Only」並填入你的 IP;沒有固定 IP 就選「Unrestricted」。選好按「Next」,再完成安全驗證(2FA / 郵件或簡訊驗證碼)。

第六步:複製三項資訊貼回 ExAgg
建立完成後,會顯示 API Key、Secret、Passphrase 三項(Passphrase 就是你剛剛自訂的那組)。三樣一起複製,貼回 ExAgg 的「新增交易所 → KuCoin」,三格都要填,缺一項都連不上。
KuCoin 特有的注意事項
- Passphrase 是建金鑰時自訂的,不是登入密碼;忘了無法找回,只能刪除重建。
- 只留 General 就好:General 就是唯讀權限,能讀到主帳戶、交易帳戶與理財(Earn)餘額。畫面上的「KuCoin Earn」是訂閱/贖回的操作權限,不是讀取範圍,不要勾,以免多開不必要的權限。
- 三件套一起貼:連線失敗最常見的原因是漏貼 Passphrase 或貼錯欄位。
常見問題 FAQ
唯讀金鑰外流,KuCoin 的錢會被動嗎?
不會。沒開交易與提現權限的金鑰,呼叫這些接口會被 KuCoin 伺服器直接拒絕;對方最多看到餘額與紀錄。詳見唯讀 API Key 安全嗎?。
API Passphrase 忘記了怎麼辦?
無法找回。到 API 管理頁刪除舊金鑰,重建一把並記好新 Passphrase。
金鑰存在哪裡?
Key、Secret、Passphrase 都只存在你手機的系統安全儲存區(iOS Keychain / Android Keystore),不上傳伺服器。
怎麼撤銷?
登入 KuCoin → API 管理,刪除該金鑰即可立刻永久失效。
連好之後呢?
三件套貼進 ExAgg,KuCoin 的主帳戶、交易帳戶與理財部位就會匯進總資產畫面。其他三件套交易所的接法:OKX API Key 申請教學、Bitget API Key 申請教學。