- 網頁端在「頭像 → API 與連線 → 建立 API key」，App 端在「左上角九宮格 → API → 建立 API key」。
- 核心許可權有三種：讀取（查詢）、交易（下單撤單）、提幣（轉出資產）；給第三方工具的 Key 永遠不要開提幣。
- 未繫結 IP 且帶交易或提幣許可權的 Key，閒置 14 天會被自動刪除；模擬盤 Key 不受此限制。
- Secret Key 和 Passphrase 等同於密碼，丟失無法找回，洩露後應立刻刪除 Key 重新建立。
本文目錄 11
API Key 是讓程式代替你訪問歐易賬戶的「鑰匙」：自己寫指令碼查行情、查餘額、自動下單，或者把賬戶接入第三方交易工具，都需要先建立 API Key。它的許可權很大，一旦設定不當或被洩露，損失可能和賬號被盜差不多。本文按歐易官方文件和幫助中心（核對於 2026 年 10 月）整理申請步驟、每項設定的含義，以及最重要的安全原則。
API Key 只適合確實需要程式化交易的使用者。只是手動買賣，不需要建立任何 API Key。
申請前要知道的
建立成功後，你會得到三樣東西，缺一不可：
| 名稱 | 由誰生成 | 作用 |
|---|---|---|
| API Key | 系統隨機生成 | 相當於使用者名稱，標識這把鑰匙 |
| Secret Key | 系統隨機生成 | 用來給每個請求籤名，相當於密碼 |
| Passphrase | 你自己設定 | 呼叫介面時必須提供的口令 |
另外，歐易幫助中心註明：賬戶資產規模（AUM）需超過 100 美元才能建立 API Key，主賬戶和子賬戶都適用。
在哪裡建立 API Key
網頁端：登入歐易，點選右上角頭像 →「API 與連線」→「建立 API key」。
App 端：點選首頁左上角的九宮格圖示 → 往下滑，點選「API」→「建立 API key」。
建立時需要依次填寫：
- 備註名：給這把 Key 起個名字，建議寫明用途，例如「行情指令碼」「某某工具」；
- 賬戶：選擇 Key 歸屬的賬戶（主賬戶或某個子賬戶）；
- 用途：按頁面提供的選項選擇；
- IP 地址白名單：限制只有指定 IP 才能使用這把 Key（下文詳解）；
- 許可權：勾選這把 Key 能做什麼；
- Passphrase（密碼短語）：自己設定一個口令。
建立完成後，頁面會顯示 API Key 和 Secret Key。請立即妥善儲存，之後無法再次檢視 Secret Key；丟了只能刪除重建。
許可權怎麼選
歐易 API Key 的核心許可權有三種，一把 Key 可以同時擁有一種或多種：
| 許可權 | 能做什麼 | 建議 |
|---|---|---|
| 讀取 | 查詢賬戶餘額、賬單、訂單歷史等 | 只看資料的程式開這一項就夠 |
| 交易 | 下單、撤單、劃轉、調整賬戶設定等 | 程式需要替你下單時才開 |
| 提幣 | 把資產提到外部地址 | 自己用也儘量不開，第三方工具絕對不開 |
幫助中心還列出了幾項更細的許可權：劃轉（在你的賬戶之間轉移資金，所有賬戶可見）、借幣和賺取（只有賬戶具備相應功能資格時才顯示）。幫助中心說明，原本已開啟交易許可權的 Key 會自動獲得這三項許可權；新建 Key 時按需勾選即可。
選擇的原則只有一條：最小許可權，程式需要什麼就給什麼，多一項都不給。
Passphrase 是什麼
Passphrase 是你自己設定的一序列埠令，每次呼叫私有介面都要連同 API Key、簽名一起傳送。歐易只儲存它加密後的雜湊值，忘記後無法找回，只能刪除 Key 重新建立。建議使用和登入密碼不同的獨立口令，並儲存在密碼管理器裡。
IP 白名單與 14 天自動刪除規則
繫結 IP 後，只有來自白名單 IP 的請求才會被接受。即使 Secret Key 洩露，別人從其他地方也無法使用。
- 每把 Key 最多可以繫結 20 個 IP 地址，支援 IPv4、IPv6 和網段格式，多個地址用逗號或空格分隔；
- 程式跑在雲伺服器上時，填伺服器的固定公網 IP；
- 來自非白名單 IP 的請求會返回錯誤碼 50110。
歐易對未繫結 IP 的 Key 有一條重要規則：未繫結 IP、且擁有交易或提幣許可權的 API Key，閒置 14 天後會被自動刪除。只有呼叫了需要 API Key 鑑權的介面（如查詢餘額、下單）才算「使用過」；只調用公開行情介面，即使帶上了 Key 也不算。WebSocket 只有登入那一步算使用。這類 Key 的最近使用記錄，可以在安全中心檢視。模擬盤的 API Key 不會被刪除。
子賬戶 API Key
如果你用子賬戶隔離不同策略的資金，需要在目標子賬戶下建立 API Key，並使用這個子賬戶自己的 Key、Secret Key 和 Passphrase。主賬戶和子賬戶的憑證不要混用。一個子賬戶一把 Key，一個策略出問題時，影響範圍就限制在這個子賬戶的資金內。
模擬盤 API Key
建議先在模擬盤裡把程式跑通，再考慮實盤。模擬盤的 Key 需要單獨建立，路徑是：
登入歐易 → 交易 → 模擬交易 → 個人中心 → 建立模擬賬戶 API key
呼叫時，請求頭要加上 x-simulated-trading: 1。實盤 Key 和模擬盤 Key 不能混用，用錯環境會返回錯誤碼 50101。具體寫法見 歐易 API Python 教程。
API Key 安全清單
- 永遠不給第三方工具開提幣許可權。歐易幫助中心也明確提示，下單和管理訂單都不需要提幣許可權；
- 能綁 IP 就綁 IP，這是 Secret Key 洩露後的最後一道防線；
- Secret Key 和 Passphrase 等同於密碼：不要發到聊天群、截圖、工單裡，也不要直接寫進程式碼上傳到網上，推薦存放在環境變數或密碼管理器中；
- 一個工具一把 Key，停用某個工具時直接刪除對應的 Key，不影響其他程式；
- 定期清理：在 API 管理頁面檢視所有 Key，刪除不再使用的；
- 懷疑洩露就先刪除：先在歐易刪除這把 Key，再建立新的，刪除後對方立刻無法再操作你的賬戶；
- 賬戶本身的安全同樣重要，務必開啟通行金鑰或身份驗證 App，見 歐易賬戶安全設定教程。
警惕「量化機器人」騙局
API 相關的詐騙大多打著「量化」「AI 機器人」「穩賺套利」的旗號，常見套路包括：
- 在社群裡推廣「保證收益」的機器人，要求你建立帶提幣許可權的 Key 併發給對方；
- 以「託管代操作」為名，索要 Secret Key、Passphrase 甚至登入驗證碼；
- 誘導你下載來路不明的「量化軟體」，竊取 Key 或賬戶資訊；
- 用不明來源的「回測截圖」證明收益，再讓你充值或轉賬。
沒有任何機器人能保證盈利。要求你開提幣許可權、交出 Secret Key 或承諾固定收益的，都應該直接拒絕。對方自稱歐易官方時，可以在歐易官網的「官方渠道驗證」頁面核實。
下一步
- 用程式碼呼叫 API：歐易 API Python 教程
- 不寫程式碼也能用的自動化工具：歐易策略交易新手教程
- 術語速查：API Key 是什麼
常見問題
歐易 API Key 在哪裡申請？
網頁端登入後點擊右上角頭像，進入「API 與連線」，選擇「建立 API key」；App 端點選左上角九宮格，往下滑找到「API」，再點「建立 API key」。歐易幫助中心註明，賬戶資產規模需超過 100 美元才能建立 API Key，主賬戶和子賬戶都適用。
Passphrase 忘了怎麼辦？
Passphrase 是你建立 API Key 時自己設定的密碼，歐易只儲存加密後的結果，無法幫你找回。忘記後只能刪除原來的 Key，重新建立一個。
為什麼我的 API Key 突然失效了？
常見原因是這把 Key 沒有繫結 IP，又開了交易或提幣許可權，連續 14 天沒有呼叫需要鑑權的私有介面，被系統自動刪除。繫結 IP 可以避免這種情況。此外，Key 被手動刪除、許可權被修改，或者呼叫時用錯了實盤/模擬盤環境，也會導致報錯。
第三方量化工具需要哪些許可權？
只看行情和賬戶資料的工具，開「讀取」即可；需要替你下單的工具，再加「交易」。任何第三方工具都不需要「提幣」許可權，對方如果要求開啟，基本可以判斷存在風險。
模擬盤的 API Key 和實盤通用嗎？
不通用。模擬盤 Key 要在模擬交易裡單獨建立，呼叫時請求頭需帶上 x-simulated-trading 1；用實盤 Key 訪問模擬盤（或反過來）會返回 50101 環境不匹配錯誤。
歐易的介面、費率和規則會調整，如與本文不一致，請以歐易官網最新資訊為準。