資料方法論
我們的資料方法論:來源、涵蓋、缺口,以及我們不宣稱什麼
這一頁講的是資料怎麼來、涵蓋到哪、以及哪裡還不夠。所有數字都是資料庫實測值(快照日 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 的實測值。我們只公布量得出來的數字,量不出來的就不寫。
| 資料集 | 涵蓋區間 | 規模 |
|---|---|---|
| 上市個股日K | 2004 年起 | 520 萬筆/1,682 檔(含 311 檔已停止交易,262 檔有官方下市日) |
| 上櫃個股日K | 1994 年起 | 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"延伸閱讀