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

OKX 的資產想跟其他交易所一起看總額,申請一把唯讀 API Key 就能做到:App 只能讀取餘額與紀錄,下單、提幣都會被 OKX 伺服器擋掉,金鑰就算外流也動不了錢(原理見唯讀 API Key 安全嗎?)。

OKX 跟幣安不同的一點:除了 Key 和 Secret,還要多設定一組 Passphrase(密碼短語),三個一起才能用。

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

申請步驟（手機 App）

以下用 OKX App 示範。若用網頁版,流程相同:登入後點右上角頭像 →「API」(直接開啟),一樣建立唯讀金鑰即可。

第一步:打開左上角功能選單

登入 OKX App,在首頁「Exchange」分頁點左上角的九宮格圖示,展開全部功能。

第二步:進入 API

在展開的「More(更多)」清單裡,點「API」(</> 圖示)。

第三步:點「Create API key」建立金鑰

進入 API 管理頁後,每把金鑰會顯示用途(Purpose)、權限(Permissions)、建立時間等資訊。點下方的「Create API key」開始新建一把。

第四步:命名、權限只選「Read」,並設定 Passphrase

在建立表單裡:

• API name:輸入好認的名字(例如 exagg demo)。
• Account:選「Main account(主帳戶)」。
• Permissions:只點「Read(讀取)」,「Withdraw(提幣)」與「Trade(交易)」保持不選。
• Passphrase:往下捲動會要求你自訂一組 Passphrase(密碼短語)——這是你自己設定的,請務必記下來,OKX 之後不會再顯示,連客服也查不到。
• Trusted IP access(信任 IP)非必填,唯讀金鑰可保持關閉。

完成安全驗證後金鑰就建立好。把 API Key、Secret、Passphrase 三個都複製,貼回 ExAgg 的「新增交易所 → OKX」——三樣都要填,少一項都連不上。

OKX 特有的注意事項

• Passphrase 是自己設的,忘了救不回來:它不是登入密碼,是建金鑰時自訂的短語。忘記就只能刪掉金鑰重建。
• 要建 V5 API:OKX 目前的 API 版本是 V5,追蹤 App 都走 V5 接口,別選到舊版。
• 三件套缺一不可:Key、Secret、Passphrase 三項要同時貼進 App,常見錯誤是漏了 Passphrase 導致連線失敗。

常見問題 FAQ

唯讀金鑰外流,OKX 的錢會被動嗎?

不會。唯讀金鑰呼叫下單或提幣接口,OKX 伺服器會直接回傳權限錯誤。對方最多能看到你的餘額與交易紀錄,詳見唯讀 API Key 安全嗎?。

Passphrase 忘記了怎麼辦?

無法找回,OKX 不會再顯示,客服也查不到。處理方式:到 API 管理頁刪除舊金鑰,重建一把並記好新 Passphrase。

金鑰貼進 ExAgg 後存在哪裡?

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

想撤銷授權怎麼做?

登入 OKX → API 管理頁,刪除該金鑰即可立刻永久失效,重建也隨時可以。

連好之後呢?

三件套貼進 ExAgg,OKX 的資產就會即時匯進總資產畫面,跟幣安、Bybit 放在同一個數字裡看。其他交易所的接法:Binance 幣安 API Key 申請教學、Bitget API Key 申請教學。