Cookie settings
We use essential cookies to keep you signed in and secure, and analytics cookies to improve the product. We never use them for ad tracking.Learn more
Cookie settings
We use essential cookies to keep you signed in and secure, and analytics cookies to improve the product. We never use them for ad tracking.Learn more
Building an AI agent? Start with /llms.txt for the full site index.
Overview
說明各資料家族的覆蓋範圍、更新節奏與 data_gaps 判讀方式。
你可以從左側導覽查看所有資料集文件，也可以先從 Quick Start 建立第一個 request。
若要讓 agent 或內部工具讀取文件，TW Market Data 已提供 /openapi.json、/llms.txt、/llms-full.txt 作為 machine-readable 入口；MCP 仍為 preview/planned。
Coverage 指的是資料集在 ticker、日期、財報期間或事件類型上的可用範圍。Coverage 會隨資料來源揭露節奏與產品化進度持續更新，不應假設所有資料集都已完整覆蓋。
建議把 coverage 視為可觀測狀態，而不是固定常數。實際可用範圍應以 API 回應與 docs 說明為準。
Freshness 指的是某筆資料最近一次可用更新時間。不同資料集更新頻率不同，例如日線價格、月營收、季報與事件資料的揭露節奏並不相同。
在跨資料集查詢時，請同時檢查 freshness 與資料時間欄位，避免把不同更新節奏的資料視為同一時間點。
data_gaps 表示資料缺口或來源限制，是研究流程中應保留的訊號。請不要把缺口直接當成 0 或自動補值。
建議在 pipeline 中將 data_gaps、source_role、lineage 一起保存，以便後續審計與回溯。
平台目前使用下列狀態語意，協助你在系統內區分可用程度與風險邊界。
查看 response 中的 freshness、source_role、lineage、data_gaps 欄位，再搭配對應 endpoint 的 docs 說明與參數限制。
建議同時參考資料集介紹頁（/datasets）與單一資料集頁（例如 /datasets/twse-daily-price、/datasets/institutional-flow）。
若需要特定產業、資料集或企業級導入，請聯繫我們。