歐易 API 怎麼申請？API Key、金鑰與 Passphrase 設定

歐易 API Key 在賬戶的 API 管理 頁面建立，需要先開啟雙重驗證（2FA）。和幣安不同的是，建立時你要 自己設定一個 Passphrase（API 密碼），系統再生成 API Key 與 Secret Key，三者缺一不可。許可權分讀取、交易、提幣，建議只開程式用到的專案，並繫結 IP 白名單。

只想查行情或資金費率，不需要任何 Key，見 用 API 獲取資金費率。

申請歐易 API 需要什麼條件？

建立 API Key 不收費，常見的前提條件有：

1. 開啟雙重驗證：例如身份驗證器 App，這是建立 Key 的必要條件。
2. 完成身份認證：一般需要先完成身份認證才能使用交易相關功能，要求以頁面提示為準。
3. 所在地區可以使用服務：歐易的服務範圍因地區而異，是否能使用以官方說明為準。
4. 想交易合約，賬戶要能交易合約：例如賬戶模式需要支援永續合約，否則程式呼叫合約介面會失敗。

歐易 API Key 怎麼建立？

選單位置與按鈕名稱可能隨版本調整，以頁面顯示為準，大致流程如下：

1. 登入歐易網頁版，在個人中心或賬戶選單裡找到 API 相關的管理頁面。
2. 選擇建立 API Key，填寫備註名，例如“資金費率記錄”。
3. 設定 Passphrase：按頁面要求輸入一組自己的密碼，這組密碼之後無法在頁面上檢視，要另外儲存好。
4. 選擇許可權：讀取、交易、提幣，按用途勾選。
5. 填寫 IP 白名單（可選但強烈建議），可以填一個或多個固定 IP。
6. 完成安全驗證後，頁面顯示 API Key 與 Secret Key，立即儲存。

儲存時建議把三樣東西放在密碼管理工具或加密檔案裡，而不是記在手機備忘錄或聊天記錄裡。

OKX API Passphrase 是什麼？忘了怎麼辦？

Passphrase 可以理解為“這個 Key 的第二道密碼”。程式呼叫私有介面時，請求頭裡要同時帶上 API Key、簽名、時間戳與 Passphrase，歐易核對全部正確才會執行。

幾個容易混淆的地方：

• 它不是登入密碼，也不是資金密碼，只屬於這一個 API Key。
• 每個 Key 可以設不同的 Passphrase，建議不要和任何其他密碼重複。
• 忘記後一般無法找回，頁面也不會再顯示，只能刪除舊 Key、重新建立並更新程式設定，以頁面提示為準。

因為多了一層 Passphrase，單獨外洩 Secret Key 時攻擊者還缺一樣東西，但不要因此放鬆。很多洩露是整份配置檔案一起外洩，三者往往同時落入他人手中。

API Key、Secret Key、Passphrase 有什麼區別？

專案	由誰產生	作用	可以給別人嗎
API Key	系統生成	標識是哪個 Key，放在請求頭	儘量不要
Secret Key	系統生成	對請求計算簽名	絕對不行
Passphrase	你自己設定	額外的驗證密碼，放在請求頭	絕對不行

簽名的做法是用 Secret Key 對“時間戳 + 請求方法 + 路徑 + 請求內容”計算雜湊，再放進請求頭。具體格式以 歐易 API 文件 為準，建議使用成熟的開源庫，不要自己拼接後又隨手貼到論壇求助，求助時也一定要先刪掉 Key 與密碼。

歐易 API 許可權怎麼選？

許可權	能做什麼	適合的用途	建議
讀取	查詢資產、持倉、訂單、賬單	記賬、盈虧統計、監控	預設開啟
交易	下單、撤單、調整槓桿與保證金	網格、套利、自建策略	程式要下單才開
提幣	把資產提到外部地址	極少數自建資金排程	不建議開啟

歐易的交易許可權通常同時涵蓋現貨與合約，不像幣安分成現貨和合約兩個開關，所以開交易許可權前，要確認程式只會做你預期的市場。若想限制程式能動用的資金，可以用子賬戶把資金隔開，再在子賬戶下建立 Key，子賬戶的開通條件以歐易頁面為準。

歐易 API 要不要繫結 IP 白名單？

建議繫結。繫結後，即使 API Key、Secret Key 與 Passphrase 全部外洩，攻擊者從其他 IP 發出的請求也會被拒絕。

繫結的前提是程式執行在固定 IP 的機器上，例如雲伺服器。家用網路的 IP 可能變動，繫結後要留意連線失敗的情況。未繫結 IP 的 Key 在有效期或許可權方面可能有額外規則，以歐易官方說明為準。完整的安全做法見 交易所 API 安全。

歐易模擬盤 API 怎麼用？

歐易提供模擬交易環境，適合在投入真實資金前測試程式。模擬盤需要在模擬交易模式下另外建立 API Key，呼叫時也要按文件標示為模擬交易請求，具體方式以官方文件為準。

建議的順序是：先用公開介面練習讀取資料，再用模擬盤 Key 測試下單邏輯，最後才用小額真實資金執行。模擬盤的成交深度與真實市場不同，測試結果只能參考。

建立後怎麼測試？呼叫失敗怎麼排查？

建議先只開讀取許可權，用程式查詢一次賬戶餘額。返回成功，代表 Key、Passphrase、簽名與 IP 都設定正確，之後再按需要加開交易許可權。歐易的介面會在返回內容裡附上程式碼，成功時是 "0"，失敗時會帶有錯誤程式碼與說明。常見的失敗原因有：

1. Passphrase 輸入錯誤：大小寫、空格或複製時多帶了字元，都會驗證失敗。
2. 簽名對不上：時間戳格式、請求路徑或請求內容和簽名時使用的不一致。
3. 本機時間偏差：時間戳與伺服器時間相差太多會被拒絕，開啟系統自動校時即可。
4. IP 不在白名單：程式所在機器的出口 IP 與設定不同。
5. 許可權或賬戶模式不符：例如只開了讀取卻呼叫下單介面，或賬戶模式不支援該產品。

各錯誤程式碼的含義以歐易官方文件為準。排查時不要把完整的請求頭貼到公開場合，裡面就包含 Key 與 Passphrase。不再使用的 Key 要及時刪除，換機器或換程式時直接建立新 Key 更安全。

歐易 API 和幣安 API 有什麼不同？

專案	歐易	幣安
組成	API Key + Secret Key + Passphrase	API Key + Secret Key
交易許可權	通常是一個交易開關	現貨及槓桿、合約分開勾選
提幣許可權	有，不建議開	有，須先設定 IP 限制才能開
公開資金費率介面	/api/v5/public/funding-rate	/fapi/v1/premiumIndex
合約手續費（一般使用者）	掛單 0.02%、吃單 0.05%	掛單 0.02%、吃單 0.05%

兩家通過 API 下單的手續費都與手動下單相同。舉例：程式以吃單開一筆 20,000 USDT 的永續倉位，手續費是 20,000 × 0.05% = 10 USDT，再以吃單平倉又是約 10 USDT，進出一次合計約 20 USDT。若開平倉都改用掛單，是 20,000 × 0.02% × 2 = 8 USDT。費率細節見 歐易手續費指南，幣安的申請步驟見 幣安 API 怎麼申請。

還沒有賬戶的話，註冊入口見文末或 邀請碼頁。