元大 Web API：申請、串接、自動下單一次搞懂
用 Python、JavaScript 等任意語言，直接串接元大「槓桿全球贏家」官方 Web API，跨外匯、黃金、美股 CFD 自動下單。本頁帶你看懂 API 優勢、與 MT5 EA 的差別、申請三步驟與串接範例。
還不熟「程式交易」的全貌？先看上游入門 → 程式交易是什麼。本頁專注在「元大 Web API 怎麼申請、怎麼串」。
一句話：元大「槓桿全球贏家」提供官方 Web API（REST ＋ WebSocket），對槓桿保證金客戶免費、免月費開放。用任意語言即可串接、跨市場自動下單，比封閉的 MT5 EA 更自由。開戶 → 申請 API 金鑰 → 串接三步即可上線。
元大 Web API 是什麼？
它是元大期貨「槓桿全球贏家」交易系統的官方應用程式介面：讓你的程式直接和交易伺服器溝通——查報價、查部位、自動下單，不必透過人工點擊或第三方平台。採 REST ＋ WebSocket 雙協議、資料走 JSON 標準格式，任何主流語言都能接。
元大 Web API 的優勢
WebSocket 即時報價
報價以 WebSocket 主動推播、低延遲，量化／高頻策略接收行情更即時，不必輪詢硬問。
REST ＋ WebSocket 雙協議
REST 負責登入與下單、WebSocket 負責即時報價，分工清楚、整合單純。
一個帳號跨市場
外匯、黃金、原油、全球指數、美股 CFD 同一帳號部署策略，不必切換平台。
任意語言、自由整合
用 Python／JS／Java 等任意語言，自由接 AI 模型、資料庫、Discord／LINE 通知，自由度遠勝 MQL EA。
免月費
對元大槓桿保證金客戶免費開放，無額外月費或 API 使用費；交易仍適用標準點差與隔夜利息。
官方、正規
元大期貨官方 API，邏輯自己掌握、帳戶安全；勿用來路不明的 API／神 EA，詳見 防詐提醒。
API vs MT5 EA vs 手動交易｜完整比較
同樣是自動化，工具決定了你的自由度。想看「程式交易整體概念」可回 程式交易入門；這裡直接比規格：
| 比較項目 | 手動交易 | MT5 EA | 元大 Web API |
|---|---|---|---|
| 24 小時運作 | ❌ | ✅ | ✅ |
| 程式語言 | — | MQL5 限定 | Python／JS／Java…任意 |
| 即時報價 | 人工看盤 | 平台內事件 | WebSocket 主動推播 |
| 多市場跨商品 | 需切換 | 受平台限制 | 一帳號全市場 |
| 整合 AI／外部資料 | ❌ | 困難 | 自由整合 |
| 回測整合 | ❌ | MT5 內建 | 自由（Backtrader 等） |
| 適合對象 | 短線手動 | 入門量化 | 開發者、量化團隊 |
👉 用過 MT5 EA、卡在語言與整合？升級 Web API 是自然的下一步。EA 搬家的痛點與解法，見 程式交易頁的「EA 搬家」段落。
API 申請流程｜三步驟
- 開立槓桿保證金帳戶：API 對槓桿保證金客戶免費開放。線上開戶，或加 LINE 由業務協理史本安協助。
- 取得 API 金鑰與憑證：開戶後申請 API Key／密碼與交易帳戶；真實連線位址與文件由官方提供。
- 程式端完成串接：REST 登入 → 訂閱報價 → 送出第一筆單。完整端點、參數與錯誤碼見 開發者使用指南。
※ 具備基本程式能力者，從取得金鑰到完成第一筆下單測試，通常 1～3 天可完成。
Python 串接範例｜三段式流程
⚠ 程式碼為流程示意。下方示範 REST 登入 → WebSocket 報價 → REST 下單的標準三段式寫法。真實連線位址（endpoint）、API 金鑰與 SDK 文件，需完成開戶後由業務協理史本安提供官方資料；請勿使用網路上來路不明的 API 來源。
# 1) REST 登入 → 取得 Token（密碼以 SHA-256 加密） import requests, hashlib, json, websocket REST = "https://api.example.com/rest" # 真實位址開戶後提供 pw = hashlib.sha256("你的密碼".encode()).hexdigest() tok = requests.post(REST, json={"MT":"Login", "UserInfo":{"login":"API_KEY","password":pw}}).json()["Tok"] # 2) WebSocket 訂閱即時報價（主動推播） def on_msg(ws, m): d = json.loads(m) if d.get("MT") == "Q": q = d["Q"]; print(q["s"], q["b"], q["a"]) # 商品 買 賣 ws = websocket.WebSocketApp("wss://api.example.com/ws", on_message=on_msg) # 3) REST 送出市價單（qty 為「合約單位」，非手數） def order(symbol, side, qty): return requests.post(REST, json={"MT":"OrdReq","Tok":tok, "OrdReq":{"symbol":symbol,"side":side,"qty":qty,"type":"MARKET"}}).json()
三段式骨架其實很單純：登入拿 Token → 訂報價 → 下單。完整端點、限價／停損停利、部位查詢與 10 大常見錯誤，都整理在 開發者使用指南。
API 名詞速查
第一次接觸 API，先把這幾個常見名詞搞懂：
請求／回應式介面，用 HTTP 一來一回。本 API 用於登入與下單。
長連線、伺服器可主動推播。本 API 用於即時報價，比輪詢更即時。
API Key 是你的身分鑰匙；登入後拿到 Token，後續請求都帶著它證明身分。
API 的連線位址（網址）。真實 endpoint 於開戶後由官方提供。
市價單即時以市場價成交；限價單指定價格才成交，兩者都可由 API 送出。
資料交換的標準文字格式，請求與回報都用它，任何語言都好解析。
先用模擬帳號測試你的程式
真倉前，用模擬帳號跑通登入、報價與下單流程，零風險、無使用期限。
元大 Web API 常見問題 FAQ
Q1：申請 API 需要付費嗎？
API 對元大槓桿保證金客戶免費開放，僅需完成開戶即可申請 API 金鑰，無額外月費或 API 使用費。實際交易仍適用標準點差與隔夜利息。
Q2：沒有程式基礎可以用 API 嗎？
建議至少具備 Python 或 JavaScript 基礎。若完全沒程式背景，可先請工程師協助，或先看 程式交易入門 建立概念。我們提供文件與範例降低門檻。
Q3：API 支援哪些程式語言？
凡支援 HTTP 與 WebSocket 的語言皆可串接，包含 Python、JavaScript（Node.js）、Java、C#、Go 等。資料走 JSON 標準格式，整合主流框架都沒問題。
Q4：API 和 MT4／MT5 EA 有什麼差別？
MT5 EA 受限於 MetaTrader 平台與 MQL5 語言，難整合外部 AI 或自訂風控；Web API 可用任意語言、整合任何外部系統，自由度與擴充性遠勝 EA。詳見上方比較表。
Q5：API 串接需要多久？
具備基本程式能力者，從取得金鑰到完成第一筆下單測試，通常 1～3 天。我們提供 REST 與 WebSocket 範例加速串接。
Q6：可以用 API 操作哪些商品？
涵蓋外匯、黃金與貴金屬、原油、全球指數、美股 CFD，一個帳號跨市場部署策略。各商品規格與保證金可查 商品規格試算。
Q7：怎麼拿到真實的 API 連線位址與文件？
為了帳戶安全，真實 endpoint、Token 與 SDK 文件於完成開戶後由業務協理史本安提供官方資料。請勿使用網路上來路不明的 API 來源，避免資金與帳戶風險。可加 LINE @yuantaforex 申請。
※ 本文為一般教育性資訊，說明元大 Web API 的功能與串接方式，不構成投資建議或獲利保證。程式碼為流程示意，真實 API 規格、連線位址與申請條件以元大期貨官方公告為準；請務必使用券商官方提供之 API，切勿使用來路不明來源。差價合約（CFD）為槓桿交易，可能導致超過原始投入保證金的損失，台灣券商並無「負餘額保護」機制。交易平台為「槓桿全球贏家」。
