資料方法論

我們的資料方法論:來源、涵蓋、缺口,以及我們不宣稱什麼

這一頁講的是資料怎麼來、涵蓋到哪、以及哪裡還不夠。所有數字都是資料庫實測值(快照日 2026-07-11),不是行銷估算;下面也有一節專門寫我們「不宣稱」什麼——一家資料商願意講自己的邊界,你才有辦法判斷它其餘的話能不能信。

五項原則

官方第一手,不經二手

所有資料自官方來源收錄解析:股價來自 TWSE 與 TPEx,公司申報(月營收、財報三表、重大訊息)來自 MOPS,期貨與選擇權來自 TAIFEX。我們不向二手資料商轉購,也不混入來源不明的第三方資料。官方開放資料本身免費且權威,任何人都能自己去打——我們做的是把它整理成一致、可回溯、有歷史深度的介面。

無倖存者偏差:停止交易的個股留著

多數價格資料集會在一檔股票停止交易後把它整個移除,於是歷史宇宙只剩今天還活著的公司,回測報酬因此被系統性高估。我們保留 311 檔已停止交易個股的完整價史,其中 262 檔帶有官方登記的下市日期。這是可以驗證的:查詢任何一檔已下市代號,價史就在那裡。

每一筆都能追回出處

每一筆回應都帶 source_role 與來源標記,標明它是官方原始值還是衍生計算值。你不必相信我們的說法,可以逐欄回推它從哪個官方端點來、屬於哪一種值。研究要能重跑、要能被審,這是前提。

缺口標示,不用推估值填平

資料有缺就標成缺,不用內插或前值填平。這一點在回測裡的差別很大:被悄悄補值的序列不會報錯,只會讓結果看起來比實際好,而且你事後很難發現。我們寧可讓你看到一個洞,也不給你一個看不出來的假值。

給程式與 AI agent 用的一致介面

所有資料集共用一致的回應結構,並提供 openapi.json 與 llms.txt 供 agent 自行探索端點;每一頁在網址後加 .md 可取得純 markdown 版本。開發者以 API key 走 REST 呼叫。

涵蓋範圍(資料庫實測)

以下為快照日 2026-07-11 的實測值。我們只公布量得出來的數字,量不出來的就不寫。

資料集涵蓋區間規模
上市個股日K2004 年起520 萬筆/1,682 檔(含 311 檔已停止交易,262 檔有官方下市日)
上櫃個股日K1994 年起3,920,223 筆
月營收(MOPS 申報)2010-01 起33 萬筆/2,096 檔

數字取自資料庫實測快照(2026-07-11),會隨資料累積變動;本站所有頁面的涵蓋數字都引用同一份快照,不各自估算。

我們不宣稱什麼

以下三件事我們沒有做到,因此不會在任何頁面上宣稱。列出來不是免責,是讓你知道哪些話可以拿去用、哪些不行。

每週官方對帳:還沒有
逐值比對官方來源的驗證流程已經建好、也實際跑過一次,但目前沒有排程、不是自動的。所以我們不說「每週對帳」——那是規劃中的功能,不是現在的狀態。
MCP:preview,不是正式服務
目前沒有正式上線的 hosted MCP endpoint。MCP 相關功能標示為 preview,實際可用的整合路徑是帶 X-API-Key 的 REST API。
揭露日 point-in-time:未完全覆蓋
財報資料的 report_date(實際揭露日)尚未完整覆蓋,因此我們不宣稱「揭露日 PIT 全覆蓋」。月營收在缺少精確揭露時點時,採法定申報期限作為 knowledge date 並明確標示。價格面的 point-in-time 宇宙則不受此限,因為停止交易個股的價史是完整保留的。

自己驗一次

不必相信這一頁的說法。免金鑰的五檔(2330、2317、2454、0050、2603)可以直接呼叫,回應裡就有 source_role 與涵蓋資訊;想驗下市股,換一個已下市代號查價史即可。

curl "https://api.twmarketdata.com/v2/datasets/twse-daily-price?symbol=2330&limit=2"

延伸閱讀