OKX 交易機器人設定教學:從開通 API 到自動執行
OKX 是全球前三大的加密貨幣交易所之一,提供完整的 API 介面讓第三方工具可以安全地進行自動交易。本篇教學將一步一步帶你從零開始,完成 OKX API 金鑰的設定,並搭配 Sentinel Bot 建立你的第一個自動交易機器人。
前置準備
在開始設定之前,請確認你已完成以下準備:
- OKX 帳號:已註冊並完成身分驗證(KYC)
- 帳戶資金:交易帳戶中有足夠的資金(建議至少 100 USDT 用於測試)
- 二次驗證:已開啟 Google Authenticator 或簡訊驗證
- Sentinel Bot 帳號:已在 Sentinel Bot 註冊帳號
第一步:建立 OKX API 金鑰
1.1 進入 API 管理頁面
- 登入你的 OKX 帳號
- 點擊右上角的個人頭像
- 在下拉選單中選擇「API」
- 進入 API 管理頁面
1.2 建立新的 API 金鑰
- 點擊「建立 API 金鑰」按鈕
- 選擇用途:選擇「交易」(不是「提款」)
- 填寫 API 金鑰名稱:建議取一個有意義的名稱,例如「Sentinel-Bot-Trading」
- 設定密碼短語(Passphrase):這是一組你自訂的密碼,之後連接 API 時會用到。請務必記住,OKX 不會再次顯示
1.3 設定 API 權限
這是最關鍵的安全步驟。請務必按照以下設定:
必須開啟的權限:
- 交易(Trade):允許下單和管理訂單
- 讀取(Read):允許查詢帳戶資訊和市場數據
絕對不要開啟的權限:
- 提款(Withdraw):即使你的 API 金鑰外洩,攻擊者也無法提走你的資金
這一點非常重要,我們再強調一次:永遠不要為交易機器人的 API 金鑰開啟提款權限。
1.4 設定 IP 白名單
OKX 強烈建議為 API 金鑰綁定 IP 白名單。未綁定 IP 且具有交易權限的 API 金鑰,如果 14 天內未使用,會被自動刪除。
如果你使用 Sentinel Bot 的雲端服務:
- 在 Sentinel Bot 設定頁面中可以找到需要加入白名單的伺服器 IP
- 將該 IP 填入 OKX 的 IP 白名單欄位
如果你使用 Sentinel Bot 的桌面版用戶端:
- 你的 API 金鑰儲存在本地端,交易請求從你的電腦發出
- 可以將你的公網 IP 加入白名單(注意:如果你的 ISP 使用動態 IP,可能需要定期更新)
1.5 完成驗證並儲存金鑰
- 完成 Google Authenticator 或簡訊驗證
- 系統會顯示三組關鍵資訊:
- API Key:你的 API 金鑰識別碼
- Secret Key:用於簽名 API 請求的密鑰
- Passphrase:你在步驟 1.2 設定的密碼短語
重要提醒: Secret Key 只會在建立時顯示一次,之後無法再查看。請立即將這三組資訊安全地保存下來。
建議的保存方式:
- 使用密碼管理器(如 1Password、Bitwarden)
- 離線保存在加密的文件中
- 不要用明文存在記事本或截圖保存
第二步:在 Sentinel Bot 中設定 OKX 連接
2.1 進入交易所設定
- 登入 Sentinel Bot
- 進入帳號設定或交易所連結頁面
- 選擇「新增交易所」
- 從列表中選擇「OKX」
2.2 輸入 API 金鑰資訊
填入你在第一步取得的三組資訊:
- API Key:你的 API 金鑰識別碼
- Secret Key:你的密鑰
- Passphrase:你設定的密碼短語
2.3 安全性說明
在 Sentinel Bot 的零知識安全架構下:
桌面版用戶端:
- API 金鑰使用作業系統的安全儲存機制加密(macOS Keychain / Windows Credential Manager)
- 金鑰永遠不會離開你的電腦
- 交易訊號由雲端產生,但實際下單由本地用戶端執行
雲端版:
- API 金鑰以加密方式儲存在伺服器端
- 所有 API 通訊使用 TLS 加密
2.4 測試連線
設定完成後,點擊「測試連線」按鈕。系統會嘗試讀取你的 OKX 帳戶餘額來驗證連線是否成功。如果看到你的帳戶餘額資訊,表示連線設定正確。
常見連線問題:
- 驗證失敗:檢查 API Key、Secret Key 和 Passphrase 是否正確(注意前後是否有空格)
- IP 限制錯誤:確認 Sentinel Bot 伺服器 IP 已加入白名單
- 權限不足:確認已開啟「交易」和「讀取」權限
第三步:建立你的第一個交易機器人
連線成功後,就可以開始設定自動交易機器人了。
3.1 選擇策略類型
根據你的經驗和目標選擇適合的策略:
新手推薦 — DCA 策略:
- 定期自動買入 BTC 或 ETH
- 設定每次買入金額和頻率
- 最簡單、風險最可控
有經驗者推薦 — 技術指標策略:
- 選擇均線交叉、RSI、MACD 等策略
- 設定進場條件、止盈止損
- 需要先進行回測驗證
如果你不確定該用什麼策略,建議先閱讀我們的幣圈自動交易完全攻略了解各策略的優缺點。
3.2 設定交易參數
以一個簡單的 EMA 交叉策略為例:
交易對:BTC/USDT
時間框架:4 小時
進場條件:EMA(20) 向上穿越 EMA(60)
出場條件:EMA(20) 向下穿越 EMA(60)
止損:進場價 -3%
止盈:進場價 +6%
每次投入:總資金的 10%
3.3 回測驗證(強烈建議)
在啟動機器人之前,務必先進行回測驗證:
- 在 Sentinel Bot 的回測頁面設定相同的策略參數
- 選擇至少 6 個月的歷史數據
- 檢查回測結果的關鍵指標:
- 總報酬率是否為正
- 最大回撤是否在你的承受範圍內
- 夏普比率是否大於 1
- 交易次數是否具統計意義(至少 30 次)
如果回測結果不理想,調整參數後重新回測。不要跳過這一步。詳細的回測方法請參考回測完整教學。
3.4 啟動機器人
回測結果滿意後:
- 確認所有參數設定正確
- 確認你的 OKX 交易帳戶有足夠餘額
- 點擊「啟動」按鈕
- 系統會開始監控市場,在符合條件時自動下單
第四步:監控與管理
4.1 日常監控要點
機器人啟動後,你不需要時時盯著,但建議每天至少檢查一次:
- 損益狀態:查看機器人的總損益和今日損益
- 開倉狀態:確認當前是否有未平倉的部位
- 錯誤紀錄:查看是否有下單失敗或連線中斷的錯誤
4.2 何時應該停止機器人
以下情況建議暫停機器人:
- 連續虧損超過預設上限:例如連續 5 筆虧損或總虧損超過 15%
- 市場出現極端事件:重大監管消息、交易所出問題等
- 策略績效持續偏離回測結果:實盤表現明顯差於回測
- 你要調整策略參數:先停止再調整,不要在運行中修改
4.3 定期策略檢視
建議每週花 15-30 分鐘檢視策略績效:
- 比較實際績效與回測預期
- 觀察市場環境是否發生變化
- 根據需要微調參數(但避免過度調整)
- 查看策略墓地了解哪些策略正在失效
OKX API 進階設定
子帳號 API
OKX 支援子帳號功能。如果你運行多個策略,建議為每個策略建立獨立的子帳號和 API 金鑰,這樣可以:
- 更清楚地追蹤每個策略的績效
- 限制每個策略可使用的資金
- 降低單一 API 金鑰洩露的風險
API 請求限制
根據 OKX 官方文件,API 有以下請求限制:
- 下單:60 次/2 秒(每個交易對)
- 查詢帳戶:10 次/2 秒
- 市場數據:20 次/2 秒
一般的自動交易策略不會超過這些限制,但如果你同時運行很多個交易對的高頻策略,就需要注意。
V5 API 特性
OKX 目前使用 V5 版本的 API,根據 OKX API 文件,V5 版本的主要特性包括:
- 統一帳戶支援(現貨、合約、槓桿共用一個帳戶)
- WebSocket 推送支援(即時接收市場數據和訂單狀態)
- 更完善的錯誤碼和回應格式
Sentinel Bot 完整支援 OKX V5 API 的所有交易功能。
安全性最佳實踐
API 金鑰安全 10 條守則
- 絕不開啟提款權限:這是最基本也最重要的原則
- 綁定 IP 白名單:限制 API 只能從特定 IP 使用
- 使用強密碼短語:Passphrase 至少 16 個字元,包含大小寫和數字
- 不要分享 API 金鑰:任何請你提供 API 金鑰的人都值得懷疑
- 定期更換金鑰:建議每 3 個月更換一次 API 金鑰
- 不要截圖保存:截圖可能被同步到雲端相簿而外洩
- 使用密碼管理器:安全地管理你的所有金鑰和密碼
- 開啟 2FA:確保你的 OKX 帳號有二次驗證保護
- 監控 API 活動:定期在 OKX 後台查看 API 的使用記錄
- 發現異常立即撤銷:如果發現可疑活動,立即刪除 API 金鑰
常見的安全威脅
- 釣魚攻擊:假冒 OKX 或交易工具的網站騙取你的 API 金鑰
- 惡意軟體:電腦中的木馬程式竊取已保存的金鑰
- 社交工程:假裝是客服人員要求你提供 API 資訊
應對方式:永遠只在官方網站操作、保持電腦和瀏覽器更新、不要點擊來路不明的連結。
常見問題
Q1:OKX API 金鑰會過期嗎?
不會主動過期,但有兩種情況會被自動刪除:(1) 未綁定 IP 且具有交易權限的金鑰 14 天未使用會被刪除;(2) 你手動在 OKX 後台刪除。建議綁定 IP 白名單以避免自動刪除。
Q2:我可以建立多組 API 金鑰嗎?
OKX 允許每個帳號建立多組 API 金鑰。建議為不同用途建立不同的金鑰,例如一組用於 Sentinel Bot 交易、一組用於數據分析工具。
Q3:API 金鑰洩露了怎麼辦?
立即登入 OKX 帳號,刪除該 API 金鑰。然後檢查帳戶是否有異常交易。因為你沒有開啟提款權限(對吧?),所以即使金鑰洩露,攻擊者也無法轉走你的資金。
Q4:OKX 的統一帳戶和經典帳戶有什麼差別?
OKX 的統一帳戶允許你用同一個帳戶同時交易現貨、合約和槓桿,資金可以共用。這對自動交易來說更方便,因為不需要在不同帳戶之間轉帳。API 操作上也更簡潔。
Q5:Sentinel Bot 支援 OKX 的合約交易嗎?
支援。Sentinel Bot 支援 OKX 的現貨交易和合約交易(包含永續合約)。合約交易支援 1-125 倍槓桿的回測和自動執行。但提醒:合約交易風險更高,槓桿會同時放大獲利和虧損。
Q6:設定過程中遇到問題怎麼辦?
你可以透過以下管道取得幫助:
- Sentinel Bot 平台內的客服功能
- OKX 官方客服(24 小時在線)
- Sentinel Bot 社群(Telegram / Discord)
Q7:OKX API 有免費使用額度限制嗎?
OKX API 本身是免費使用的,沒有額外的 API 使用費用。你只需要支付正常的交易手續費。不過要注意 API 的請求頻率限制,超過限制會被暫時封鎖請求。
Q8:我可以用 OKX 的模擬盤(Demo Trading)來測試嗎?
OKX 提供模擬盤功能,你可以在模擬環境中測試 API 連線和交易邏輯,不需要用真實資金。建議在正式啟動自動交易前,先在模擬盤上測試至少一週。
結語
設定 OKX 交易機器人的過程看似複雜,但只要按照本教學的步驟操作,大約 15-20 分鐘就能完成。最重要的是在設定過程中牢記安全原則:不開啟提款權限、綁定 IP 白名單、妥善保管金鑰。
完成設定後,建議遵循以下流程:回測驗證 → 模擬交易 → 小額實盤 → 逐步放大。不要急著投入大量資金,先確認一切運作正常再說。
想了解更多關於加密貨幣交易機器人的知識,可以參考我們的加密貨幣交易機器人完整指南。
祝你的自動交易之旅順利。
免責聲明:本文內容僅供教育與資訊參考用途,不構成任何投資建議或推薦。加密貨幣交易具有高度風險,價格波動劇烈,您可能損失全部投入資金。使用槓桿交易風險更高,可能導致超過本金的損失。API 交易涉及技術風險,包括但不限於連線中斷、下單失敗、系統故障等。過去的績效不代表未來表現。在進行任何投資決策前,請審慎評估自身的風險承受能力,並諮詢專業的財務顧問。本文提及的 OKX 交易所相關功能和介面可能隨時變更,請以 OKX 官方網站的最新資訊為準。Sentinel Bot 團隊不對因使用本文資訊而產生的任何損失承擔責任。