Skip to content

docs(TaiwanStockPriceAdj): 補充還原因子的更新時點與基準日說明 - #170

Open
linsamtw wants to merge 1 commit into
masterfrom
feature/price-adj-factor-update-timing-note
Open

docs(TaiwanStockPriceAdj): 補充還原因子的更新時點與基準日說明#170
linsamtw wants to merge 1 commit into
masterfrom
feature/price-adj-factor-update-timing-note

Conversation

@linsamtw

Copy link
Copy Markdown
Contributor

背景

Backer 使用者來信詢問:TaiwanStockPriceAdj 對「除息當日」的還原因子,設計上是否應在當日更新即反映,還是本就預期延後一個交易日(T+1)?並希望文件補上更新時點的說明,方便自動化流程對接。

文件原本只寫了資料更新時間,未說明還原因子本身的更新時點與基準日,故補上。

新增內容

TaiwanStockPriceAdj 段落的 bullet list 之後、!!! example 之前,加入一個 ??? note 摺疊區塊,共三點(皆為對外可觀察的行為):

  1. 基準日 —— 還原價為回溯計算,以最新交易日為基準往前累乘還原係數,因此事件當日的還原價恆等於該日原始價,調整反映在該日「之前」的歷史資料上。這一點最容易被誤解成「當日沒更新」。
  2. 更新時點 —— 除權息 / 減資 / 股票分割 / 面額變更的還原係數,於事件當日的盤後更新時即納入計算,不會延後至次一交易日。
  3. 休市順延 —— 事件的排定日若遇全市場休市(例如颱風停市)而順延,還原調整以實際發生交易的日期為準,而非原定日期。

修改檔案

檔案 內容
docs/tutor/TaiwanMarket/Technical.md 中文版 ??? note 區塊
docs/tutor/TaiwanMarket/Technical.en.md 英文版,同上
docs/llms-full.txt TaiwanStockPriceAdj 條目新增一行純文字 - Note:

docs/llms.txt 僅為頁面索引,不需異動。

使用者(Backer)來信詢問「除息當日的還原因子是否當日即更新,或本就預期
T+1」,文件未載明此行為,故補上。

新增內容(三點,皆為對外可觀察行為):

1. 還原價為回溯計算,以最新交易日為基準往前累乘,因此事件當日的還原價
   恆等於該日原始價,調整反映在該日「之前」的歷史資料。
2. 除權息 / 減資 / 股票分割 / 面額變更的還原係數於事件當日盤後更新時即
   納入計算,不會延後至次一交易日。
3. 事件排定日遇全市場休市(如颱風停市)而順延時,還原調整以實際發生交易
   的日期為準,而非原定日期。

修改檔案:

- docs/tutor/TaiwanMarket/Technical.md:TaiwanStockPriceAdj 段落,於 bullet
  list 之後、!!! example 之前插入 `??? note` 摺疊區塊
- docs/tutor/TaiwanMarket/Technical.en.md:同上,英文版
- docs/llms-full.txt:TaiwanStockPriceAdj 條目新增一行純文字 Note

docs/llms.txt 僅為頁面索引,不需異動。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant