大綱
Toggle元大 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 申請有門檻嗎?
❓ 元大 Spark API 可以用 Python 嗎?
❓ 用 Mac 可以串元大 Spark API 嗎?
❓ 為什麼帳號密碼正確還是登不進去?
❓ 元大會教我寫串接程式嗎?
資料來源:元大證券〈元大 SPARK API〉專區與 API 說明文件(申請流程、正式與測試環境、Python 設定、登入帳號格式);作者 2026/11/5 接通元大 Spark API 的實作紀錄(扣掉換憑證約 10 分鐘)。
延伸閱讀
成交值排行怎麼看?老手盤中看的三張榜,我用 Spark API 每分鐘更新
券商 API 查報價有限制嗎?1,999 檔每分鐘更新,我用 Spark API 守 3 條線
⚠️ 風險提示
程式交易可能因斷線、延遲、程式錯誤或報價異常造成損失;透過 API 在正式環境送出的委託都是有效交易指令,一經成交即須自行承擔交易風險與交割義務。期貨屬槓桿商品,損失可能超過原始保證金,交易前請詳閱風險預告書。本文僅分享個人串接與工具開發經驗,不構成任何投資建議。