為 AI Agent 打造的台股資料 API

為什麼適合 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）

這 5 檔免金鑰可直接打：2330 台積電 / 2317 鴻海 / 2454 聯發科 / 0050 / 2603。其他股票或資料集，到 /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 而生。兩者可並用。