大綱
ToggleMT5 的 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,000 | 1,000(0.01 手) |
| 黃金 XAUUSD | 100 盎司 | 1 |
| 白銀 XAGUSD | 5,000 盎司 | 50 |
| 西德州原油 XTIUSD | 1,000 桶 | 10 |
| 那斯達克 NAS100、道瓊 US30 | 1(每點 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 的順序
- 先把 EA 的進出場規則寫成文字,跟程式碼分開。
- 照CFD API 串接教學把登入、報價、第一筆單串通。
- 逐商品核對手數單位和代碼。
- 停損、改停損、平倉,每一種都小量試過一次。
- 加上認單和時間轉換,再讓策略接手。
EA 和 API 程式的差別,見EA是什麼?從MT5自動交易到元大的API串接程式。我自己整理了一份逐條檢查清單和逐商品對照表,搬程式前照著檢查一輪;每支 EA 寫法不同,清單要對著程式一起看才有用。手上有 MT5 的 EA 想搬過來,帶著你的程式,加 LINE @yuantacfd 預約一對一,我帶你一起串。
❓ 常見問題
❓ MT5 的 EA 可以直接在元大槓桿全球贏家跑嗎?
❓ 為什麼黃金手數會差 1,000 倍?
❓ 為什麼改停損之後停利不見了?
❓ API 有 magic number 嗎?
資料來源:作者 2026/10/1~10/2 於元大槓桿全球贏家帳戶實際送單測試,與元大 API 規格書;各商品 1 手單位對照元大期貨 CFD 規格表。最小下單量為作者實測,以 API 商品清單回傳為準。
延伸閱讀
不會寫程式也能串 CFD API?我用 AI 寫出自己的交易工具
我把 SAR 指標寫成 CFD 程式交易工具,串接 API 後最難的不是公式
CFD 程式交易串接 API,連線沒斷報價卻停了:我做斷線警報的經驗
⚠️ 風險提示
程式交易仍可能因斷線、系統延遲、程式錯誤或報價異常造成損失,券商端停損也可能因跳空或價差擴大,以較差的價格成交。外匯保證金與差價契約(CFD)屬高風險槓桿商品,損失可能超過原始保證金,交易前請詳閱風險預告書。本文僅分享串接經驗,不構成任何投資建議。