Cookies 使用設定
我們使用必要 cookies 維持登入與安全，並使用分析 cookies 改善產品體驗。不會用於廣告追蹤。了解更多
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）。
若需要特定產業、資料集或企業級導入，請聯繫我們。