資料品質保證¶
FinMind 的資料來自官方公開揭露管道。為了確保您拿到的每一筆資料都與官方來源一致,我們建立了一套持續運作的驗證機制,並把每月的驗證結果公開在資料品質總覽。
我們如何確保資料品質¶
01 與官方來源交叉核對
抽樣代表性代號與期間,將 FinMind 的數字與官方公開揭露的同一數字逐格核對,計算一致比例。
02 每月全面檢測
每月對資料集執行 9 項自動檢測,涵蓋更新時效、交易日涵蓋、官方來源與跨資料集核對、查詢一致性與數值一致性,全程只透過公開 API 進行。
03 依官方來源即時更新
官方來源若有更新或補充,我們會同步更新資料,並在更新公告說明,各資料集報告也會列出對應的資料維護紀錄。
檢測項目¶
每個資料集依資料性質適用下列項目;不適用的項目(例如清單型資料沒有交易日涵蓋)會標示為「不適用」。
| 檢測項目 | 檢測方式 |
|---|---|
| 資料更新時效 | 比對最新資料日與最近交易日(或應有期別),確認資料依發布週期同步更新。 |
| 交易日涵蓋率 | 依官方交易日曆抽樣(最近一段期間+歷年每年抽樣),逐日查詢全市場資料筆數,確認每個交易日都有資料,且筆數與鄰近交易日水準相當。 |
| 補行交易日涵蓋 | 逐日查詢期間內所有週六補行交易日,確認資料完整涵蓋,且筆數與前一交易日水準相當。 |
| 與官方來源一致率 | 抽樣上個月與歷年代表期間(清單型資料則核對現行清單全數),將 FinMind 資料與官方公開揭露的同一數字逐格交叉核對,計算一致比例;國際股價等由資料來源提供的資料,則與資料來源的原始值逐格核對。 |
| 跨資料集一致性 | 以公開 FinMind API 抽樣上個月數個交易日與一個歷史年份,將彼此相關的資料集互相勾稽(例如日成交量與逐筆成交加總、個股法人買賣與市場合計、財報小計與其組成項目),在已知且合理的口徑差異下計算一致比例。 |
| 查詢方式一致性 | 同一天以不同查詢參數(單日、區間、指定代號)各取一次,逐格確認結果一致。 |
| 欄位格式一致性 | 按年度統計數值欄位的小數位數與型別,確認各期間格式一致。 |
| 數值與主鍵一致性 | 確認數量與金額為非負、價格與成交量相互對應、最高價不低於最低價、開收盤落在高低區間、買賣超等於買進減賣出,以及主鍵欄位完整且不重複。 |
| 每日內容獨立性 | 計算每日整日資料的指紋(排除日期欄),確認不同日期的內容各自獨立。 |
結果標示¶
| 標示 | 意義 |
|---|---|
| 已驗證 | 該資料集本期所有適用項目皆通過。 |
| 通過 | 該項目本期檢測通過。 |
| 資料特性說明 | 檢測結果反映的是資料本身的特性(例如官方來源開始提供的日期、市場交易制度),報告中附有說明。 |
| 不適用 | 此類資料不適用該項目。 |
| 規劃中 | 該資料集將於後續納入此項目(目前用於跨資料集一致性)。 |
每月更新¶
- 每月上旬執行一次全面驗證,完成後更新資料品質總覽與各資料集報告,頁首標示本期月份與檢測日期。
- 各資料集報告附有可重現的查詢參數,您可以用自己的 token 呼叫 FinMind API 自行驗證。
- 資料維護紀錄只連結已發布的更新公告,與公告內容一致。
抽樣驗證的範圍
交易日涵蓋、官方來源一致率等項目採抽樣方式進行,以合理的查詢量涵蓋最近期間與歷年代表日期。報告結論適用於本期抽樣範圍;若您在使用上有任何疑問,歡迎透過聯絡我們與我們聯繫。