深色模式

指南

核心觀念

資料是收盤後資料：T 日的資料通常在 T+1 清晨 03:00 到 09:00 之間發佈，每次發佈是一個不可變的完整版本（release）。

資料從哪裡來

  1. 證交所、櫃買中心公告的資料經整理入庫。
  2. 建置程式每天 03:00 到 08:45 每 15 分鐘檢查一次；資料到齊就發佈新版，寫入物件儲存。
  3. API 提供「目前版本」與各版本的內容。
  4. SDK 釘在某一版，取用資料並快取在裝置上。

Release

  • 版本號為 YYYY-MM-DD.N：日期是資料的交易日，N 是當天第幾次發佈。
  • 三大法人資料通常 T+1 02:20 才入庫，偶爾延遲 2 到 4 天。部分資料集較晚就緒時，會先發 .1（未就緒的沿用前一版），到齊後再補發 .2。
  • 已發佈的內容不會改，修正一律以新版發佈。發現錯誤時可撤回某版，目前版本會退回上一個有效版。
  • 每筆資料帶 finality：preliminary 表示最新一期仍可能更正，final 表示已過修正期。

Session 釘選

  • 同一個 session 內的所有請求都來自同一版，畫面上的 K 線與表格不會一半舊、一半新。
  • 不傳 session 時使用預設 session，新版發佈後會自動換上，見 自動換版與事件。
  • 自己建立的 session（iOS pinRelease()、Android beginSession()）不會自動換版，最長有效 24 小時。

快取

  • 每檔證券的每個資料集切成數個分塊：日頻資料為「去年以前」「今年到上月底」「本月」三塊。
  • 分塊以內容雜湊命名、永不修改，裝置上可以永久快取；每天通常只需重新下載「本月」那一小塊。
  • iOS、Android 的磁碟快取預設上限 50 MB，超過時依最近使用淘汰；取回的每個分塊都會驗證雜湊。
  • Web SDK 沒有磁碟快取，請自行搭配瀏覽器快取或記憶體快取。

分塊種類與雜湊規則見 資料模型。