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

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

第一次串接元大槓桿全球贏家 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 步:送出第一筆單、查成交

第一筆單用你能接受的最小數量。送出後做三件事:

  1. 看成交回報有沒有回來,是成交還是被拒。
  2. 打開交易軟體,確認部位、數量、方向都對。
  3. 平倉時帶上原本那張單的單號,再確認一次部位真的沒了。如果這張單開倉時帶了停損,一般平倉會被拒,要改用修改條件單的方式出場(見MT5 的 EA 搬到 CFD API 的坑 3)。

要注意的地方:成交回報是整個帳戶共用的,你在手機上手動下的單也會推到程式裡,程式要能分辨哪張是自己下的。送單後如果逾時、斷線、結果不明,先查單,不要直接重送,不然可能變兩張。

🧭 走完這 5 步之後

到這裡你已經串通了,但離「可以放著跑」還有一段:停損要怎麼掛、斷線怎麼辦、程式當掉時部位怎麼保護。停損在 API 裡的特殊之處,見MT5 的 EA 搬到 CFD API 的 5 個坑;斷線的處理,見全自動交易的風險。

每個人的策略和電腦環境不同,要對著你的程式一起看。卡在哪一步,加 LINE @yuantacfd 預約一對一,我帶你一起串。

❓ 常見問題

❓ 串接元大 CFD API 要先申請嗎?

要。先開立元大槓桿全球贏家帳戶,再到元大期貨CFD 的 API 申請頁申請 API 權限,開通後拿到 API 金鑰。

❓ 正式帳號登入一直失敗怎麼辦?

先確認有沒有用電子憑證對登入資料簽章。作者實際串接時,少了這一步正式帳號會一直被拒。

❓ 登入成功但收不到成交回報?

確認即時連線也完成了登入。登入要照網頁請求登入、開即時連線、即時連線再登入的順序走完。

❓ 第一筆單要注意什麼?

用最小數量,送出後回交易軟體確認部位,再帶原單號平倉確認一次。結果不明時先查單,不要直接重送。

資料來源:作者串接元大槓桿全球贏家 API 的實作與程式紀錄(2026 年 9~10 月);各商品 1 手單位對照元大期貨 CFD 規格表。登入與下單細節以元大 API 規格書為準。

延伸閱讀

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

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

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

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

槓桿全球贏家API串接指南,開啟你的程式交易之路

⚠️ 風險提示

API 下單會直接送到你的帳戶,程式錯誤可能造成非預期的部位與損失,請先小量測試並逐筆對帳。外匯保證金與差價契約(CFD)屬高風險槓桿商品,損失可能超過原始保證金,交易前請詳閱風險預告書。本文僅分享串接經驗,不構成任何投資建議。