← 台股快照資料庫

首頁 / 指標庫 / 快照查詢

快照查詢 · 時光機(Point-in-Time)

「回測時,我怎麼確定當時真的查得到這個數字?」

一般看盤軟體給你的是「最新修正版」數字,拿去回測就等於偷看未來。 這個功能不一樣:查任一歷史日期,回傳的是那一天實際可得的版本 —— 公告後被修正的數字不會穿越回來。這是零前視偏差(未來函數)的資料層解法。

實際範例:同一檔股票的七個歷史視角

同一個代號、七個不同的 as_of 日期, 各自回傳那一天實際查得到的版本。其中兩個查詢日當天沒有公告,表格直接 標示回退,而不是安靜地給你最接近的數字。這一段是 server 端算好寫進頁面的 ——不需註冊、不需金鑰、不吃配額。

GET /v1/valuation/vintage?stock_id=2330&as_of=YYYY-MM-DD
查詢 as_of實際回傳版本本益比股價淨值比殖利率公告時滯
2024-07-012024-07-0129.306.901.34%當日
2024-12-252024-12-2527.137.051.20%當日
2025-05-012025-04-30(該日無公告,回退到前一版)20.075.491.87%當日
2025-10-102025-10-09(該日無公告,回退到前一版)25.588.151.18%當日
2026-01-022026-01-0225.908.221.07%當日
2026-05-312026-05-29(該日無公告,回退到前一版)31.6610.370.93%當日
2026-07-192026-07-17(該日無公告,回退到前一版)30.7910.080.96%當日
代號 2330 · 7 個歷史視角中有 4 個查詢日當天沒有公告,回傳的是該日之前最後一個可得版本——這正是「as_of 只往回看、不往前偷」的機制本身。免費級不需註冊、不吃配額;任意 as_of 與任意個股的程式化回看為付費級,差別在覆蓋範圍,不在數字。歷史統計,非投資訊號。

方法論透明

快照不是「回推」出來的,是我們每天真的存一次檔累積起來的版本史。

01

當日版本定格

每個公告日的數字就此定格,成為一張可回溯稽核的快照 —— 事後修正不覆寫。

02

as_of 回傳當時版

查歷史日期時,回傳「該日或之前最後一次公告」的版本,公告後才出現的修正不會穿越回來。

03

快照序列可追修正

同一指標在不同快照日的完整版本史都留著,你能看到每次公告後數字被修正的軌跡。

04

分級回看窗口

個人級可回看近 90 天窗口;量化級解鎖完整歷史快照序列,做長期無前視回測。

術語速查(白話卡)

聽起來很硬的名詞,其實一句話就懂。

資料快照Point-in-Time
把某一天的資料庫狀態拍照存起來。白話:像 3 月 1 日拍一張照,之後數字再怎麼改,那張照片永遠是 3 月 1 日的樣子。
前視偏差Look-ahead bias
回測用到了當時還查不到的資訊。白話:等於考試偷看答案,成績再好也是假的。台股圈也叫「未來函數」。
快照序列Vintage series
同一個數字在不同日期的所有版本。白話:財報常事後更正,這裡把每一版都留著,能還原「當時到底寫多少」。
as_ofAs-of date
你要回到哪一天的視角。白話:填 2024-03-01,系統就只給你那天當下查得到的數字,假裝今天是那天。

想自己跑一次?

免費級不用註冊,直接用示範金鑰試打這個功能的 API;想解鎖歷史快照回看與全個股覆蓋,看方案。

本站提供的是資料與工具,不是投資建議、不是明牌、不保證獲利。所有數字均為官方公開源的原樣呈現或本站透明可驗證的衍生加工,任何買賣決策與後果由使用者自行負責。 快照忠實還原歷史可得版本,但資料仍受官方源可得性限制(best-effort、T+1、無 SLA)。快照本身是資料工具,非投資建議。

常見問題

什麼是前視偏差(look-ahead bias)?

回測用到了當時還查不到的資訊。財報常事後更正,但一般軟體只留最新修正版,拿去回測就等於偷看未來。

快照是回推出來的嗎?

不是。快照是每天真的存一次檔累積起來的版本史。每個公告日的數字就此定格成一張可回溯稽核的快照,事後修正不覆寫。

查歷史日期會拿到哪個版本?

回傳「該日或之前最後一次公告」的版本;公告後才出現的修正不會穿越回來。同一指標在不同快照日的完整版本史都留著,可以看到數字被修正的軌跡。