台股 API 是什麼？入門完整指南

台股 API 是什麼

台股 API 是把台灣證券交易所（TWSE）、證券櫃檯買賣中心（TPEx）與公開資訊觀測站（MOPS）的官方公開資料，整理成程式可以直接呼叫的介面。你不必自己爬網頁、拆 CSV、處理民國年與編碼，就能把股價、月營收、三大法人籌碼與公司事件接進回測、儀表板或 AI agent 流程。

換句話說，台股 API 本身不生產資料——資料一直都在官方網站上，而且是免費的。它做的是把散在不同系統、不同格式、不同發布時點的同一批公開資料，收斂成一致的欄位與查詢方式，讓「查台積電 2015 年到今天的日線」變成一次請求，而不是一個爬蟲專案。

台股資料由誰發布

剛開始接台股資料時最容易卡住的一點，是以為有一個統一的資料源。實際上台股的公開資料分屬四個機構，各自有自己的網站、欄位命名與發布節奏：

• TWSE（台灣證券交易所）——上市股票的日線價格、成交統計、三大法人買賣超。
• TPEx（證券櫃檯買賣中心）——上櫃／興櫃市場的對應資料，網域與欄位名稱都與 TWSE 不同。
• MOPS（公開資訊觀測站）——公司申報：月營收、財報三表、重大訊息與公司基本資料。
• TAIFEX（台灣期貨交易所）——期貨與選擇權。

所有台股資料產品——包括我們——最終都源自這四個機構。差別不在「有沒有資料」，而在資料落地之後發生了什麼：欄位有沒有標準化、上市與上櫃能不能對齊、歷史有沒有累積、每一筆能不能追回它的出處。

台股 API 能取得哪些資料

「除了股價還有什麼？」是入門最常問的一題。以 TW Market Data 為例，主要分四類：

• 日線價格——上市自 2004 年、上櫃自 1994 年，含已停止交易個股的完整價史。
• 月營收——MOPS 每月營收申報，自 2010-01 起、涵蓋 2,096 檔，含 YoY／MoM。可查詢的歷史深度依方案而定。
• 三大法人籌碼——外資、投信、自營商買賣超為獨立資料集，可依股票與日期查詢。
• 財報三表、股利與公司事件——同樣來自 MOPS 申報。

每一個資料集的涵蓋區間與已知缺口，都標示在它自己的資料集頁面上，不會統一宣稱「全都有」。這些資料同樣適合給程式或 AI agent 使用：回應採一致結構並帶有 source_role 與來源軌跡，另提供 openapi.json 與 llms.txt 供 agent 自行探索端點；開發者以 API key 走 REST 呼叫。

怎麼讀懂一個台股資料集

拿到任何一個台股資料集時，先看三件事，它們決定這份資料能不能拿來做決策：

• 涵蓋區間（coverage）——資料從哪一天開始、到哪一天為止、涵蓋幾檔標的。沒有標示區間的資料集，你無法判斷一段空白是「市場沒交易」還是「我們沒有」。
• 來源軌跡（lineage）——這一筆是從哪個官方端點來的、屬於原始值還是衍生值。TW Market Data 每一筆回應都帶 source_role 與來源標記。
• 資料缺口（data gaps）——缺漏是被標示出來，還是被補成內插值。這一點最常被忽略，也最傷：把缺口悄悄填平的資料源，會讓回測結果看起來比實際更好。我們的做法是保留缺口並揭露，而不是填平它。

第四件值得一問的事是已下市的標的還在不在。多數價格資料集會在一檔股票停止交易後把它整個移除，於是你的歷史宇宙只剩今天還活著的公司，回測報酬因此被高估——這就是倖存者偏差。目前 TWSE 上市日線自 2004 年起、涵蓋 1,682 檔、約 520 萬筆，其中 311 檔已停止交易的個股保留完整價史（262 檔帶官方下市日）；上櫃日線自 1994 年起，月營收自 2010-01 起、涵蓋 2,096 檔。

挑選時先問三個問題

挑台股資料 API 時，先問三個問題：資料是不是直接來自官方第一手來源、每一筆能不能追回它的出處、涵蓋區間與已知缺口有沒有誠實標示。這三題問完，多數選項就會自己分出高下。

免費層能測到哪

台股 API 有免費的嗎？有，而且有兩種。官方 TWSE 與 TPEx 的 OpenAPI 本身就是免費的第一手來源，不需註冊。TW Market Data 這一側則提供免費層：每月 500 次請求、1 支 API key、每分鐘 60 次，涵蓋基礎資料集（不含財報三表），限非商業使用；另有 5 檔（2330、2317、2454、0050、2603）免金鑰即可直接呼叫，適合先把串接跑通再決定要不要升級。各方案的配額與可查詢深度列在方案頁。

和官方 TWSE OpenAPI 差在哪

官方 OpenAPI 免費、權威，是所有台股資料的第一手來源，能自己處理的話它就夠用——這一點值得講清楚，不必為了推銷而貶低它。實務上的差別集中在三處：官方端點一支一支分開，各自有自己的欄位與格式，要跨資料集比對得自行 join；多數開放端點提供的是當期資料，歷史深度需要自己長期累積；請求額度與資料格式請以官方公告為準。

TW Market Data 不取代官方，而是把同一批官方資料整理成一致的 schema，補上歷史深度與來源軌跡，讓系統與 AI agent 一次查完。如果你只需要當期快照、也願意自己寫解析與累積，直接打官方端點是完全合理的選擇。