MT5 的 EA 搬到 CFD API,我串接時踩的 5 個坑

MT5 的 EA 搬到 CFD API,我串接時踩的 5 個坑

MT5 的 EA 可以搬到元大槓桿全球贏家 CFD API,策略邏輯能保留,但下單的部分要整段改寫,最常出錯的是手數、商品代碼、停損、認單、時間這 5 件 MT5 幫你做掉的事。很多人的第一個念頭是「把下單那幾行改成呼叫 API 就好」,我實際把策略接上 API 之後發現,最先出事的通常不是策略,是這些細節。下面一個一個說,最後附搬 EA 的順序。

📌 重點先看

  • 手數不能照搬:API 的數量是合約單位,黃金和外匯的倍數差 1,000 倍。
  • 商品代碼不一樣:只有外匯和金屬有斜線,MT5 常見的 US500、USOIL 在這裡叫 SPX500、XTIUSD。
  • 停損是另一張單:改停損漏帶停利,停利會被清成 0;帶停損的單不能用一般方式平倉。
  • 沒有 magic number:只能用備註標記,手動單的回報也會推到程式。
  • 時間有兩種:報價用國際標準時間,成交回報用台灣時間。

最後更新:2026/11/10

⚖️ 坑 1:手數照搬,黃金一口氣大 1,000 倍

MT5 裡寫「0.1 手」,平台會幫你換算。API 下單的數量是「合約單位」,要自己乘:

商品1 手等於多少單位作者實測的最小下單量
歐元/美元等外匯100,0001,000(0.01 手)
黃金 XAUUSD100 盎司1
白銀 XAGUSD5,000 盎司50
西德州原油 XTIUSD1,000 桶10
那斯達克 NAS100、道瓊 US301(每點 1 美元)0.1

最常見的寫法是「全部乘 100,000」,外匯沒事,黃金就變成原本的 1,000 倍。實際換算以 API 商品清單回傳的數值為準,可以先對保證金規格表。

🏷️ 坑 2:商品代碼對不上

在 API 裡,斜線只出現在外匯和金屬(EUR/USD、XAU/USD);原油、指數、美股都沒有(XTIUSD、SPX500、AAPL)。程式如果「看到六個字母就自動加斜線」,原油會被轉成不存在的代碼。MT5 常見的 US500、USOIL,在這裡叫 SPX500、XTIUSD;有些券商帶後綴的寫法(例如 EURUSD.pro),後綴也要拿掉。

🛑 坑 3:停損是另一張單

在 MT5,停損停利是單子上的兩個欄位。在元大的 API,開倉帶停損,券商會另外建一張條件單掛著,連鎖反應有四個:

狀況我遇到的結果怎麼避
只改停損沒帶原本的停利,停利被清成 0停損停利每次一起送
用一般方式平倉有掛停損的單被拒,回「停損停利已設定」改用修改那張條件單的方式出場
補掛停損條件單方向要跟開倉相反多單的停損是賣、空單的停損是買
分辨怎麼出場停損和停利成交時,回報長得一模一樣用成交價離停損還是停利比較近來判斷

另外,作者實測多單停損看 Bid(多單平倉時賣出的價格)、空單停損看 Ask(空單平倉時買回的價格);我對照過,平台的 K 棒是用 Bid 畫的,價差變大時,圖上沒碰到、空單停損也可能被觸發。停損放多遠,可以參考ATR 指標怎麼用。

🔖 坑 4:認不出哪張是自己的單

MT5 用 magic number 區分每支 EA 的單;元大的 API 沒有這個欄位,只能用委託備註標記。成交回報是整個帳戶共用的,你在手機上手動下的單也會推到程式裡,程式要比對商品、方向、數量和備註,才知道哪張是自己的。送單後結果不明(逾時、斷線)時也不能直接重送,先查單,否則可能變兩張。

🕐 坑 5:同一個帳戶,兩種時間

報價和 K 棒用的是國際標準時間(UTC),成交回報和查單時間是台灣時間(UTC+8)。把 UTC 當成台灣時間用,時段過濾就會差 8 小時。查單時的時間格式也跟報價不同,寫程式時要分開處理。

👣 跟著做:搬 EA 的順序

  1. 先把 EA 的進出場規則寫成文字,跟程式碼分開。
  2. 照CFD API 串接教學把登入、報價、第一筆單串通。
  3. 逐商品核對手數單位和代碼。
  4. 停損、改停損、平倉,每一種都小量試過一次。
  5. 加上認單和時間轉換,再讓策略接手。

EA 和 API 程式的差別,見EA是什麼?從MT5自動交易到元大的API串接程式。我自己整理了一份逐條檢查清單和逐商品對照表,搬程式前照著檢查一輪;每支 EA 寫法不同,清單要對著程式一起看才有用。手上有 MT5 的 EA 想搬過來,帶著你的程式,加 LINE @yuantacfd 預約一對一,我帶你一起串。

❓ 常見問題

❓ MT5 的 EA 可以直接在元大槓桿全球贏家跑嗎?

不行,要把下單、查單這些動作改成呼叫元大的 API,策略邏輯可以保留。

❓ 為什麼黃金手數會差 1,000 倍?

API 的數量是合約單位,外匯 1 手是 100,000 單位,黃金 1 手是 100 盎司;用外匯的倍數換算黃金,就會大 1,000 倍。

❓ 為什麼改停損之後停利不見了?

停損和停利在同一張條件單上,作者實測只改停損、沒把停利一起帶上,停利會被清成 0。

❓ API 有 magic number 嗎?

沒有,只能用委託備註標記。成交回報整個帳戶共用,手動單也會推到程式,要自己比對。

資料來源:作者 2026/10/1~10/2 於元大槓桿全球贏家帳戶實際送單測試,與元大 API 規格書;各商品 1 手單位對照元大期貨 CFD 規格表。最小下單量為作者實測,以 API 商品清單回傳為準。

延伸閱讀

不會寫程式也能串 CFD API?我用 AI 寫出自己的交易工具

CFD API 串接教學:帶你從申請、登入走到第一筆單

我把 SAR 指標寫成 CFD 程式交易工具,串接 API 後最難的不是公式

CFD 程式交易串接 API,連線沒斷報價卻停了:我做斷線警報的經驗

告別EA!探索元大槓桿全球贏家API的獨家功能與應用

⚠️ 風險提示

程式交易仍可能因斷線、系統延遲、程式錯誤或報價異常造成損失,券商端停損也可能因跳空或價差擴大,以較差的價格成交。外匯保證金與差價契約(CFD)屬高風險槓桿商品,損失可能超過原始保證金,交易前請詳閱風險預告書。本文僅分享串接經驗,不構成任何投資建議。