元大 API 串接怎麼做?我用 Python 和 AI 助手 10 分鐘接通 Spark API

元大 API 串接怎麼做?我用 Python 和 AI 助手 10 分鐘接通 Spark API

元大 API 串接最花時間的不是寫程式,是環境、憑證、帳號格式這幾個細節。我開通元大 Spark API 之後,用 Python 加上 AI 助手,從安裝環境、登入到查到第一筆台積電報價,扣掉中間換憑證的幾分鐘,大約 10 分鐘就接通。下面整理接通前要先備好的三樣東西、我實際踩到的 5 個坑,以及正式環境和測試環境怎麼選。

📌 重點先看

  • 官方申請流程:簽 API 風險預告書、下載測試軟體完成測試並上傳,再請所屬營業員開通,最後下載元件。官方寫明申請沒有財力或交易量門檻。
  • 接通前要備好三樣:API 權限、電子憑證、.NET 8 SDK。
  • 我踩到的 5 個坑,大多不是程式邏輯,而是設定檔、檔名、憑證、帳號格式、登入結果這類細節。
  • 正式環境開通 API 權限後就能連,不用申請固定 IP;測試環境才要請營業員申請固定 IP。

最後更新:2026/11/10

🔌 為什麼我要自己串 API

我想每天盤中看全市場的成交值、強勢股、弱勢股排行,原本用的看盤軟體沒有開放程式接口,資料拿不出來,只好自己串券商 API。元大 Spark API 是元大證券提供的程式交易元件,官方說明支援行情查詢與訂閱、證券與期貨下單、帳務查詢,作業系統支援 Windows、macOS、Linux,新功能以 Python 和 C# 元件為主。

我在 CFD 這邊串的是另一套 元大槓桿全球贏家API,兩套別搞混:

項目元大 Spark API元大槓桿全球贏家 API
提供的公司元大證券元大期貨
交易的商品國內證券(含條件單)、國內期貨外匯保證金、差價契約(CFD)
我拿來做什麼台股盤勢看盤網頁CFD 交易工具、斷線警報

EA 和券商 API 的差別,可以先看EA是什麼?從MT5自動交易到元大的API串接程式。

🧰 接通前先備好的三樣

要備好的說明從哪裡來
API 權限簽風險預告書、完成測試並上傳後,請所屬營業員開通元大證券 API 專區
電子憑證登入要用;舊憑證可能過不了檢核元大證券網站申請後匯入電腦
.NET 8 SDK元件用 .NET 8 開發,Python 要靠 pythonnet 套件呼叫;官方建議 Python 3.8 以上官方說明文件的 Python 設定

官方常見問題也寫得很清楚:元大只提供 API 元件讓客戶自行開發,不提供程式開發教學和除錯服務。卡住的時候要自己讀錯誤訊息找原因,這也是 AI 助手幫最多忙的地方。

🕳️ 我踩到的 5 個坑

坑看到的現象我當時的判斷
① 設定檔一啟動就跳設定檔錯誤設定檔的路徑或內容不對
② 檔名亂碼解壓縮後中文檔名變成亂碼,程式找不到檔案解壓縮時中文檔名的編碼沒對上(我第一次接通是用 Mac 筆電)
③ 憑證檢核登入時卡在憑證檢查舊憑證被擋,換成新申請的憑證就過了
④ 帳號格式帳號密碼明明正確卻登不進去帳號前面要加一個字母:證券加 S、期貨加 F(官方說明文件有寫)
⑤ 登入沒反應程式說登入送出了,卻一直沒拿到資料登入結果要從回應事件裡看,看到成功的訊息代碼才算登入

這 5 個坑都發生在「接上去之前」。每個坑實際怎麼排除,跟你的電腦環境和帳號有關。

🤖 AI 助手在這段做了什麼

從裝環境到接通這一路,AI 助手做的是讀錯誤訊息、提出可能的原因和換法;我做的是決定要不要照做,以及確認結果對不對。像憑證那關,錯誤訊息指向憑證檢核,換成新憑證再跑一次就過了。

AI 助手做的我自己做的
讀錯誤訊息,列出可能原因決定先試哪一個
提出換法、改設定確認有沒有真的登入、報價對不對
把查到的報價整理出來拿看盤軟體上的數字比對

我在 CFD 那邊用 AI 寫交易工具,也是同樣的分工,寫在不會寫程式也能串 CFD API?我用 AI 寫出自己的交易工具。

🌐 正式環境還是測試環境?

項目正式環境測試環境
用途實際交易串接測試、功能驗證
防火牆不需另外設定要請營業員申請固定 IP
可登入的帳號自己的證券、期貨正式帳號;權限依帳號個別開通,期貨帳號要另外申請只提供證券測試帳號
憑證正式憑證測試憑證
送出的委託都是有效交易指令,一經成交即有效依官方測試規則模擬(依委託書號尾碼決定成交、不成交或失敗)
服務穩定度正式交易環境官方說明屬加值服務、僅供串接測試,不保證穩定提供服務

正式環境向營業員開通 API 權限後就能連,不用申請固定 IP。但要記得:正式環境透過 API 送出的委託都算真的單,程式還沒驗證好之前,先不要放下單功能。上面兩個環境的說明,出自元大證券的API 說明文件。

👣 接通之後

接通只是起點。我用接通的 API 做出盤中三張排行榜,見成交值排行怎麼看?老手盤中看的三張榜,我用 Spark API 每分鐘更新;要讓程式整天穩定跑、全市場每分鐘更新,還得守住券商的查詢次數上限,見券商 API 查報價有限制嗎?1,999 檔每分鐘更新,我用 Spark API 守 3 條線。

想看實際畫面,或聊聊你的策略能不能做成程式,可以預約一對一交流。

❓ 常見問題

❓ 元大 API 申請有門檻嗎?

官方說明沒有財力或交易量門檻,是元大證券客戶即可申請。流程是簽 API 風險預告書、完成測試並上傳,再請所屬營業員開通。

❓ 元大 Spark API 可以用 Python 嗎?

可以。官方提供 Python 和 C# 元件,Python 透過 pythonnet 套件呼叫 .NET 8 元件,官方建議 Python 3.8 以上。

❓ 用 Mac 可以串元大 Spark API 嗎?

官方元件支援 Windows、macOS、Linux;macOS 登入時要另外指定憑證檔的路徑。多數人用 Windows 電腦,本文以 Windows 的設定為主。

❓ 為什麼帳號密碼正確還是登不進去?

我遇到的原因是帳號格式:證券帳號前要加 S、期貨帳號前要加 F。另外舊憑證也可能過不了檢核,換成新憑證再試;API 權限也是依帳號個別開通,期貨帳號要另外申請。

❓ 元大會教我寫串接程式嗎?

官方只提供 API 元件讓客戶自行開發,不提供程式開發教學與除錯服務。

資料來源:元大證券〈元大 SPARK API〉專區與 API 說明文件(申請流程、正式與測試環境、Python 設定、登入帳號格式);作者 2026/11/5 接通元大 Spark API 的實作紀錄(扣掉換憑證約 10 分鐘)。

延伸閱讀

成交值排行怎麼看?老手盤中看的三張榜,我用 Spark API 每分鐘更新

券商 API 查報價有限制嗎?1,999 檔每分鐘更新,我用 Spark API 守 3 條線

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

EA是什麼?從MT5自動交易到元大的API串接程式

從程式交易到網格交易:自動化交易的三個階段

⚠️ 風險提示

程式交易可能因斷線、延遲、程式錯誤或報價異常造成損失;透過 API 在正式環境送出的委託都是有效交易指令,一經成交即須自行承擔交易風險與交割義務。期貨屬槓桿商品,損失可能超過原始保證金,交易前請詳閱風險預告書。本文僅分享個人串接與工具開發經驗,不構成任何投資建議。