大綱
Toggle第一次串接元大槓桿全球贏家 CFD API,照「申請 → 憑證 → 照順序登入 → 拿商品清單收報價 → 送第一筆單對帳」五步走,很多常見的錯誤就能先避開。站上已經有一篇槓桿全球贏家API串接指南講整體架構;這篇換個方式,照我自己實際串接的順序走一次,每一步告訴你要做什麼、我在哪裡卡住。
📌 重點先看
- 順序很重要:網頁請求登入 → 開即時連線 → 在即時連線上再登入一次 → 之後才查資料、下單。
- 我實際串接時,正式帳號登入要用電子憑證簽章,沒簽會一直被拒。
- 先拿商品清單:每個商品的手數單位、代碼寫法都不同。
- 第一筆單回交易軟體對帳:程式說成功,不代表部位真的是你要的。
最後更新:2026/11/10
📝 第 1 步:申請 API 權限
先開立元大槓桿全球贏家帳戶,再到元大期貨CFD 的 API 申請頁申請 API,開通後會拿到 API 用的金鑰。這組金鑰跟帳號密碼一樣重要,不要貼到任何網路上的程式範例或聊天群組。
要注意的地方:程式要給別人看、或請別人幫忙除錯之前,先確認裡面沒有金鑰和密碼。API 能做什麼、適合誰,見元大槓桿全球贏家API。
🔐 第 2 步:準備電子憑證
我實際串接時,正式帳號登入除了金鑰,還要用電子憑證對登入資料簽章;沒有簽章就會一直被拒。
我卡過的地方:只寫金鑰加密碼的登入寫法,正式帳號照著寫會一直被拒,要補上憑證簽章這一步。
🔑 第 3 步:照順序登入
元大槓桿全球贏家 API 用網頁請求(RESTful)和即時連線(WebSocket)兩種方式溝通,登入照這個順序:
| 順序 | 做什麼 | 用途 |
|---|---|---|
| 1 | 用網頁請求登入 | 拿到這次連線的授權 |
| 2 | 開一條即時連線 | 之後收報價和成交回報 |
| 3 | 在即時連線上再登入一次 | 即時連線才會開始推資料 |
| 4 | 用網頁請求查資料、送單 | 回報從即時連線回來 |
要注意的地方:四段要照順序走完。我實際串接時,即時連線沒有登入,成交回報就收不到,程式不知道單有沒有成交。
📋 第 4 步:拿商品清單、收報價
登入後第一件事是查商品清單。每個商品都有自己的手數單位和代碼寫法,下單時都要對:
| 要對的欄位 | 為什麼 |
|---|---|
| 手數單位 | 外匯 1 手 100,000 單位、黃金 100 盎司、白銀 5,000 盎司、原油 1,000 桶,美國三大指數(道瓊、標普 500、那斯達克)每點 1 美元,倍數都不同 |
| 代碼寫法 | 在 API 裡,只有外匯和金屬的代碼有斜線 |
各商品的單位和保證金,可以先對保證金規格表。報價收到後,留意時間是國際標準時間(UTC),跟台灣差 8 小時;成交回報和查單時間則是台灣時間。
🧾 第 5 步:送出第一筆單、查成交
第一筆單用你能接受的最小數量。送出後做三件事:
- 看成交回報有沒有回來,是成交還是被拒。
- 打開交易軟體,確認部位、數量、方向都對。
- 平倉時帶上原本那張單的單號,再確認一次部位真的沒了。如果這張單開倉時帶了停損,一般平倉會被拒,要改用修改條件單的方式出場(見MT5 的 EA 搬到 CFD API 的坑 3)。
要注意的地方:成交回報是整個帳戶共用的,你在手機上手動下的單也會推到程式裡,程式要能分辨哪張是自己下的。送單後如果逾時、斷線、結果不明,先查單,不要直接重送,不然可能變兩張。
🧭 走完這 5 步之後
到這裡你已經串通了,但離「可以放著跑」還有一段:停損要怎麼掛、斷線怎麼辦、程式當掉時部位怎麼保護。停損在 API 裡的特殊之處,見MT5 的 EA 搬到 CFD API 的 5 個坑;斷線的處理,見全自動交易的風險。
每個人的策略和電腦環境不同,要對著你的程式一起看。卡在哪一步,加 LINE @yuantacfd 預約一對一,我帶你一起串。
❓ 常見問題
❓ 串接元大 CFD API 要先申請嗎?
❓ 正式帳號登入一直失敗怎麼辦?
❓ 登入成功但收不到成交回報?
❓ 第一筆單要注意什麼?
資料來源:作者串接元大槓桿全球贏家 API 的實作與程式紀錄(2026 年 9~10 月);各商品 1 手單位對照元大期貨 CFD 規格表。登入與下單細節以元大 API 規格書為準。
延伸閱讀
不會寫程式也能串 CFD API?我用 AI 寫出自己的交易工具
MT5 的 EA 搬到 CFD API,我串接時踩的 5 個坑
我把 SAR 指標寫成 CFD 程式交易工具,串接 API 後最難的不是公式
CFD 程式交易串接 API,連線沒斷報價卻停了:我做斷線警報的經驗
⚠️ 風險提示
API 下單會直接送到你的帳戶,程式錯誤可能造成非預期的部位與損失,請先小量測試並逐筆對帳。外匯保證金與差價契約(CFD)屬高風險槓桿商品,損失可能超過原始保證金,交易前請詳閱風險預告書。本文僅分享串接經驗,不構成任何投資建議。