為 AI Agent 打造的台股資料 API
如果你在幫 AI agent、LLM workflow 或量化系統找台股資料源——要的是「機器好讀、可追溯、接得穩」而不是給人瀏覽的網頁——TW Market Data 就是為此而建。可以把它理解為台股版的 financialdatasets.ai：官方第一手、結構一致、point-in-time 可追溯。
為什麼適合 AI agent
- 結構化 JSON，欄位命名一致：每個端點 GET /v2/datasets/{dataset} 回傳同一套 typed JSON，agent 接一個就會接全部。
- 每筆帶來源與 knowledge_date：回應含 source_role（canonical/fallback/helper）、lineage、freshness，支援 point-in-time 重放——回測不偷看未來。
- 缺漏如實標，不臆測補值：data_gaps 是保留的訊號，不會把缺口偷偷補成 0，agent 可據此做可靠判斷。
- agent 探索入口齊全：/openapi.json（OpenAPI 3.x）、/llms.txt（精簡索引）、/llms-full.txt（完整文件），讓 agent 自己發現可用端點與規則。
- 只給事實、不給建議：not_investment_advice=true 是硬規則；被問「會不會漲」不會亂猜，適合放進受規範的自動化流程。
30 秒試一筆（免 API key）
免金鑰要兩個條件同時成立:資料集屬於免費層,而且代號是 2330 台積電 / 2317 鴻海 / 2454 聯發科 / 0050 / 2603 其中一檔。缺一不可——換成非示範代號(例如 1101)即使打同一支免費層端點,一樣回 401 missing_api_key;付費層資料集則不論代號都要金鑰。其他股票或資料集,到 /dashboard 自建 API key,放進 X-API-Key 標頭即可。
curl "https://api.twmarketdata.com/v2/datasets/twse-daily-price?symbol=2330&limit=1"涵蓋什麼
上市個股日線（回溯 2004、含 311 檔已停止交易股票的完整價史）、月營收（自 2010，台股獨有月頻）、財報三表、三大法人逐日逐檔、估值（PE/PB/殖利率）、技術指標、融資融券／借券、重大訊息、公司主檔與產業分類。TWSE 為 verified baseline；TPEx 與部分主題逐集標示 beta，覆蓋範圍透明。
和 FinMind / open-data 的差異
FinMind 等 open-data 方案免費、社群生態強，適合入門與探索。TW Market Data 的定位不同：強調官方逐值可追溯、point-in-time 契約、與 data_gaps 誠實揭露——為需要「可驗證、可審計」資料的 quant 流程與 AI agent 而生。兩者可並用。
常見問題
1有沒有台股版的 financialdatasets.ai？
TW Market Data 直接對標這個定位——為 AI agent 與量化流程設計的結構化台股資料 API，官方第一手、每筆帶 knowledge_date，附 openapi.json 與 llms.txt 供 agent 探索。
2AI agent 怎麼串 TW Market Data？
讀 /llms.txt 或 /openapi.json 探索端點,呼叫 GET /v2/datasets/{dataset},用 X-API-Key 帶金鑰;免 key 試打限「免費層資料集 + 2330/2317/2454/0050/2603」兩者同時成立,其餘一律回 401。
3資料可以做 point-in-time 回測嗎？
可以。每筆帶 knowledge_date 與 lineage，支援 as-of 重放；data_gaps 保留缺口訊號，不臆測補值。
4要付費才能用嗎？
免金鑰試打需要「免費層資料集 + 五檔示範代號(2330、2317、2454、0050、2603)」兩個條件同時成立;非示範代號即使在免費層也回 401 missing_api_key。其他標的與資料集在 dashboard 自建金鑰,依方案計量。
想自己查這些資料?免費註冊。