大綱
Toggle券商 API 查報價有限制,而且超過不只是查不到:以元大 Spark API 為例,官方公開的使用限制寫明,呼叫次數超過上限會暫停服務 1 分鐘,一小時內被暫停 10 次,就停止這個帳號的 API 服務。我用它把全市場約 1,999 檔股票每分鐘更新一次,第一天盤中跑了 55 輪、失敗 0 次、沒被暫停。抓得快不難,難的是整天不被暫停,我守住的是 3 條線。
📌 重點先看
- 官方限制分「單一連線」和「單一帳號」兩層,查報價、訂閱、下單各有上限。
- 超過次數暫停 1 分鐘;一小時內暫停 10 次,帳號停用 API 服務。
- 我守的 3 條線:分批、每批之間留間隔、累計出錯就自己停。
- 寧可少更新一輪,也不要被停用。
最後更新:2026/11/10
📏 元大 Spark API 的官方限制
| 限制 | 上限 |
|---|---|
| 同一功能一秒內查詢報價或帳務(不含 K 線查詢) | 3 次 |
| K 線查詢一秒內 | 1 次 |
| 報價表單次查詢商品 | 600 檔 |
| 單一連線訂閱報價商品總數 | 2,000 檔 |
| 單一帳號訂閱商品總數 | 3,000 檔 |
| 單一帳號行情類總呼叫 | 每分鐘 1,200 次 |
| 單一帳號登入 | 每天 1,000 次 |
| 登入失敗後重新登入 | 每 4 秒 1 次 |
上表摘自元大證券 API 說明文件的使用限制說明,限制可能調整,寫程式前以官方最新版本為準。帳務類、交易類另有自己的上限,文件裡都列得到。
⛔ 被暫停和被停用不一樣
| 狀況 | 會發生什麼 | 影響 |
|---|---|---|
| 超過呼叫次數 | 暫停服務 1 分鐘,回傳「呼叫次數過多,請稍後再試」這類訊息 | 這一分鐘拿不到資料 |
| 一小時內被暫停 10 次 | 停止這個帳號使用 API 服務 | 官方寫有使用問題請洽所屬營業員 |
暫停一次只少 1 分鐘的資料;停用影響的是整個帳號的 API,同一個帳號透過 API 下單的程式也會一起停。
🛡️ 我守住的 3 條線
- 分批:全市場不一次查完,切成幾批,每批都在單次上限以內。
- 每批之間留間隔:不讓同一功能在一秒內的次數碰到上限。
- 累計出錯就自己停:程式自己數錯誤次數,到了就先停下來,不等券商來暫停。
分幾批、每批幾檔、隔多久,跟你要抓的檔數和更新頻率有關。
✋ 為什麼「自己停」最重要
我最擔心的是網路不穩、券商回錯誤訊息的那幾分鐘。這時候如果程式只會一直重試,很快就會連續被暫停,一小時累積到 10 次,整個帳號的 API 就不能用了。所以我讓程式累計出錯到設定好的次數就自己停,寧可少更新一輪。斷網、滑價這類自動交易的風險,見全自動交易的風險:斷網、滑價怎麼防?;報價停了卻沒有報錯的狀況,見CFD 程式交易串接 API,連線沒斷報價卻停了:我做斷線警報的經驗。
👣 自己寫之前先算好
- 把要抓的檔數和更新頻率寫下來。
- 對照官方限制,算出每分鐘要呼叫幾次。
- 定好分批和間隔,留一點餘裕。
- 加上錯誤計數,到了就自動停。
- 先在盤後小量跑,再上盤中。
API 怎麼接通,見元大 API 串接怎麼做?我用 Python 和 AI 助手 10 分鐘接通 Spark API;用這套更新做出來的三張榜,見成交值排行怎麼看?老手盤中看的三張榜,我用 Spark API 每分鐘更新。程式交易適不適合你,可以先看您是否適合程式交易?。
想看實際畫面,或聊聊你的策略能不能做成程式,可以預約一對一交流。
❓ 常見問題
❓ 券商 API 查詢太快會怎樣?
❓ 元大 API 一次可以查幾檔報價?
❓ API 被停用怎麼辦?
❓ 程式出錯要不要自動重試?
資料來源:元大證券 API 說明文件〈使用限制說明〉;作者 2026/11/6 以元大 Spark API 每分鐘更新全市場約 1,999 檔報價的實跑紀錄(第一天盤中 55 輪、失敗 0 次)。
延伸閱讀
元大 API 串接怎麼做?我用 Python 和 AI 助手 10 分鐘接通 Spark API
成交值排行怎麼看?老手盤中看的三張榜,我用 Spark API 每分鐘更新
CFD 程式交易串接 API,連線沒斷報價卻停了:我做斷線警報的經驗
⚠️ 風險提示
程式交易可能因斷線、延遲、程式錯誤或報價異常造成損失;透過 API 在正式環境送出的委託都是有效交易指令,一經成交即須自行承擔交易風險與交割義務。期貨屬槓桿商品,損失可能超過原始保證金,交易前請詳閱風險預告書。本文僅分享個人串接與工具開發經驗,不構成任何投資建議。