Gate.io API Key 申請教學:唯讀權限設定完整步驟(2026)

Gate.io 的資產想接進追蹤 App,申請一把唯讀 APIv4 Key 就能做到:App 只能讀取餘額與紀錄,下單、提幣都會被 Gate 伺服器擋掉,金鑰外流也動不了錢(原理見唯讀 API Key 安全嗎?)。

Gate 最大的特色(也是最大的雷):權限是逐項獨立設定的,每一項有「唯讀 / 讀寫 / 無權限」三種選擇——每一項都要選唯讀,不要留任何一項是「無權限」,否則那一塊資產就讀不到。

還沒有 Gate 帳號?先到 Gate 官方註冊頁完成註冊。

申請步驟(手機 App）

以下用 Gate App 示範。若用網頁版,流程相同:登入後進入帳戶設定裡的「API Keys」(直接開啟),一樣把每一項權限都設成「唯讀」即可。

第一步:打開「More(更多)」

登入 Gate App,在首頁功能列最右邊點「More(更多)」,展開全部功能。

第二步:進入「API」

在「Others(其他)」清單裡點「API」。

第三步:點「Create API Key(建立 API Key)」

在 API 管理頁按下藍色的「Create API Key」按鈕,開始建立一把新金鑰。

第四步:選 Trading Account,把每一項權限都設成 Read Only

這是最關鍵的一步,請照下圖逐項核對:

1. API Key Remark(備註):輸入好認的名字(例如 exagg demo)。
2. IP Permissions(選填):留空即可,唯讀金鑰不強制綁 IP。
3. Account Type(帳戶類型):一定要選「Trading Account(交易帳戶)」——選錯成「Demo Account(模擬帳戶)」會讀到假資料,對不上你的真實資產。
4. Permissions(權限):清單裡的每一個項目——Spot Trading、Perpetual Futures、Delivery Futures、Stocks、Earn、Launch、Wallets、custody、Withdraw、Options、Subaccount、Commission Details——全部都要選「Read Only(唯讀)」,不要留任何一項是可交易或可提現的權限。

確認整份清單右側都顯示「Read Only」後,按最下方的「Create API Key」,完成安全驗證(2FA / 驗證碼),接著複製 API Key 與 Secret,貼回 ExAgg 的「新增交易所 → Gate.io」。

⚠️ 兩個非設不可的重點:

1. Account Type 必選「Trading Account(交易帳戶)」——選成 Demo Account 會讀到模擬帳戶的假餘額,永遠對不上真實資產。
2. 每一個權限項目都要調成「Read Only(唯讀)」——上圖那一整排(現貨、合約、錢包、理財、提現…)無一例外全設唯讀,不要留任何可交易或可提現的權限。唯讀就足夠追蹤,把下單/提幣能力交出去違反最小權限原則。

Gate 特有的注意事項

• 逐項設定是雙面刃:粒度細,但也容易漏。口訣是「每一項都唯讀,一項都不留空」。
• 接上後某塊資產是 0? 回頭檢查那一項是不是留在「無權限」——這是 Gate 用戶最常見的排查點。
• 不要圖方便選讀寫:唯讀就夠追蹤用了,讀寫等於把下單能力交出去,違反最小權限原則。

常見問題 FAQ

唯讀金鑰外流,Gate 的錢會被提走嗎?

不會。全部設唯讀的金鑰,下單與提幣請求都會被 Gate 伺服器拒絕;對方最多看到餘額與紀錄。詳見唯讀 API Key 安全嗎?。

為什麼接上後合約(或理財)的資產是 0?

檢查建金鑰時該項權限是不是留在「無權限」。到 API Keys 頁編輯金鑰,把漏掉的項目改成唯讀,或刪掉重建一把全部唯讀的。

金鑰存在哪裡?

只存在你手機的系統安全儲存區(iOS Keychain / Android Keystore),不上傳伺服器。

怎麼撤銷?

登入 Gate → API Keys,刪除該金鑰即可立刻永久失效。

連好之後呢?

Key 貼進 ExAgg,Gate 的現貨、合約、理財就會匯進同一個總資產數字。其他交易所接法:MEXC API Key 申請教學、KuCoin API Key 申請教學。