OKX API 教學:建立金鑰、設定權限,接上自動交易

從建立 API 金鑰、選權限、設 IP 白名單,到下單被拒時每個錯誤代碼代表什麼、該怎麼處理。

最後更新 2026-11
揭露:本文的 OKX 註冊連結是 Blave 的合作連結,透過它註冊,Blave 可能獲得回饋。

還沒有 OKX 帳戶?註冊 OKX

重點整理
  • OKX API 金鑰由三樣東西組成:API Key、Secret Key、Passphrase。Passphrase 是你自己設的,忘了只能刪掉重建。
  • 自動交易只要開「讀取」和「交易」權限,「提幣」一律不開。
  • 有交易權限、沒綁 IP 的金鑰,14 天沒有動作會被 OKX 自動刪除。
  • 下單回 50004 或 51149 逾時,不代表沒成交,要先查訂單,不要直接重送。

OKX API 是什麼?

OKX API 是讓程式直接跟 OKX 帳戶溝通的介面:查餘額、查持倉、下單、撤單,都不用開網頁。自動交易程式就是透過 API 照規則下單。

用 API 要先建立一把金鑰,程式拿這把金鑰證明「我是這個帳戶授權的」。金鑰能做什麼,取決於建立時開了哪些權限。

怎麼建立 OKX API 金鑰?

註冊 OKX 帳戶
提幣權限一律不開。自動交易只需要讀取和交易。就算金鑰外洩,沒有提幣權限也搬不走你的幣。
  1. 登入 OKX 網頁版,到「個人資料 → API 和連接」,按「創建 API key」。
  2. 填 API key 名稱,選擇帳戶和用途。
  3. 設定 IP 白名單(見下一節)。
  4. 權限勾「讀取」和「交易」,「提幣」不要勾。
  5. 設定 Passphrase 並記下來。OKX 建立後不會再顯示。
  6. 完成安全驗證,記下 API Key 和 Secret Key,放在安全的地方。

三樣東西一起交給自動交易程式,缺一樣都連不上。

IP 白名單要不要設?

OKX 官方 API FAQ 寫明:有交易或提幣權限、沒綁 IP 的金鑰,14 天沒有動作就會被自動刪除。綁了 IP,金鑰不會因為閒置而過期,別人拿到金鑰也沒辦法從其他地方用。一把金鑰最多綁 20 個 IP。

要綁的話,填的是「跑程式那台機器」的對外 IP,不是你手機或平常上網的 IP。家裡的網路 IP 可能會變,變了就要把新 IP 加進白名單。

用 Blave Agent 的話:雲端主機的連接框會顯示主機 IP,照填就好。電腦版不要求綁,不綁就要記得 14 天規則。

OKX API 常見錯誤代碼

下面是自動交易最常遇到的錯誤。說明照 OKX 官方 API 文件(51008 照 Blave 下單程式的分類),處理方式是一般建議。

代碼意思怎麼處理
第一類:金鑰和權限的問題,連接或下單時就會被拒
50111API Key 無效檢查有沒有貼錯、前後有沒有多空白
50113簽章無效通常是 Secret Key 貼錯,重貼一次
50105Passphrase 不對填建立金鑰時自己設的那組,不是登入密碼
50110IP 不在白名單把跑程式那台機器的新 IP 加進白名單
50119金鑰不存在可能被刪了(例如 14 天規則),重建一把
50100API 被凍結聯絡 OKX 客服
第二類:金鑰沒問題,但這張單本身送不出去
51010目前的帳戶模式不支援現貨模式不能做合約,到帳戶模式設定改成能做合約的模式
51008保證金不足補資金,或調低策略金額
51020低於最小下單量調高策略金額,或換最小單位比較小的幣
50102請求時間戳過期跑程式那台機器的時鐘不準,打開自動對時
第三類:結果不確定,最要小心
50004API 請求逾時不要重送,先查訂單
51149下單逾時不要重送,先查訂單
50001服務暫時無法使用不要重送,先查訂單
50026系統錯誤不要重送,先查訂單

OKX 文件明寫 50004 和 51149「不代表請求成功或失敗」。單可能已經成交了,直接重送就會變成下兩次。Blave Agent 遇到這四個代碼,一律不重送同一張單:合約市價單會回頭查這張單有沒有成交,再決定下一步。其他單會停下來回報,不會自動重試。

自己寫程式接 OKX API 的話,這一點最容易出事。

用 Blave Agent 接 OKX,不用自己處理這些

上面的錯誤處理,包括遇到 50102 自動跟 OKX 對時、逾時不重送,Blave Agent 的下單程式都做好了。你只要把 API Key、Secret Key 和 Passphrase 貼進「自動下單 › 連接帳戶 › OKX」,策略就能照規則在 OKX 下單。

接真帳戶之前,建議先用模擬交易跑一段時間,不用金鑰,起始 100,000 USDT。

下載電腦版

完整步驟見〈設定交易所下單金鑰〉。從找想法到上線的整個流程見〈OKX 自動交易:從找想法、回測到上線〉。

常見問題

API 金鑰會過期嗎?
有綁 IP 的不會因為閒置過期。有交易或提幣權限、沒綁 IP 的,14 天沒有動作會被刪除。

Passphrase 忘了怎麼辦?
沒辦法找回,只能刪掉這把金鑰、重建一把,再把新的三樣東西貼回程式。

每天什麼時候最容易下單逾時?
OKX 建議避開每天 8 點、16 點、24 點(台灣時間),那是資金費結算時間,伺服器壓力最大。

風險先講

API 金鑰等於帳戶的交易授權,不要貼到不信任的網站或程式。提幣權限一律不開,用不到的金鑰就刪掉。自動交易不會讓虧損消失,只是照規則執行。用槓桿時,虧損會跟著放大。