從建立 API 金鑰、選權限、設 IP 白名單,到下單被拒時每個錯誤代碼代表什麼、該怎麼處理。
還沒有 OKX 帳戶?註冊 OKX
OKX API 是讓程式直接跟 OKX 帳戶溝通的介面:查餘額、查持倉、下單、撤單,都不用開網頁。自動交易程式就是透過 API 照規則下單。
用 API 要先建立一把金鑰,程式拿這把金鑰證明「我是這個帳戶授權的」。金鑰能做什麼,取決於建立時開了哪些權限。
三樣東西一起交給自動交易程式,缺一樣都連不上。
OKX 官方 API FAQ 寫明:有交易或提幣權限、沒綁 IP 的金鑰,14 天沒有動作就會被自動刪除。綁了 IP,金鑰不會因為閒置而過期,別人拿到金鑰也沒辦法從其他地方用。一把金鑰最多綁 20 個 IP。
要綁的話,填的是「跑程式那台機器」的對外 IP,不是你手機或平常上網的 IP。家裡的網路 IP 可能會變,變了就要把新 IP 加進白名單。
用 Blave Agent 的話:雲端主機的連接框會顯示主機 IP,照填就好。電腦版不要求綁,不綁就要記得 14 天規則。
下面是自動交易最常遇到的錯誤。說明照 OKX 官方 API 文件(51008 照 Blave 下單程式的分類),處理方式是一般建議。
| 代碼 | 意思 | 怎麼處理 |
|---|---|---|
| 第一類:金鑰和權限的問題,連接或下單時就會被拒 | ||
| 50111 | API Key 無效 | 檢查有沒有貼錯、前後有沒有多空白 |
| 50113 | 簽章無效 | 通常是 Secret Key 貼錯,重貼一次 |
| 50105 | Passphrase 不對 | 填建立金鑰時自己設的那組,不是登入密碼 |
| 50110 | IP 不在白名單 | 把跑程式那台機器的新 IP 加進白名單 |
| 50119 | 金鑰不存在 | 可能被刪了(例如 14 天規則),重建一把 |
| 50100 | API 被凍結 | 聯絡 OKX 客服 |
| 第二類:金鑰沒問題,但這張單本身送不出去 | ||
| 51010 | 目前的帳戶模式不支援 | 現貨模式不能做合約,到帳戶模式設定改成能做合約的模式 |
| 51008 | 保證金不足 | 補資金,或調低策略金額 |
| 51020 | 低於最小下單量 | 調高策略金額,或換最小單位比較小的幣 |
| 50102 | 請求時間戳過期 | 跑程式那台機器的時鐘不準,打開自動對時 |
| 第三類:結果不確定,最要小心 | ||
| 50004 | API 請求逾時 | 不要重送,先查訂單 |
| 51149 | 下單逾時 | 不要重送,先查訂單 |
| 50001 | 服務暫時無法使用 | 不要重送,先查訂單 |
| 50026 | 系統錯誤 | 不要重送,先查訂單 |
OKX 文件明寫 50004 和 51149「不代表請求成功或失敗」。單可能已經成交了,直接重送就會變成下兩次。Blave Agent 遇到這四個代碼,一律不重送同一張單:合約市價單會回頭查這張單有沒有成交,再決定下一步。其他單會停下來回報,不會自動重試。
自己寫程式接 OKX API 的話,這一點最容易出事。
上面的錯誤處理,包括遇到 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 金鑰等於帳戶的交易授權,不要貼到不信任的網站或程式。提幣權限一律不開,用不到的金鑰就刪掉。自動交易不會讓虧損消失,只是照規則執行。用槓桿時,虧損會跟著放大。