台股除權息資料 API 怎麼拿？

可以直接跑的呼叫

curl -s "https://api.twmarketdata.com/v2/datasets/dividends?symbol=2330" \
  -H "X-API-Key: sk_live_你的金鑰"

回應裡真正有的欄位

• ticker、market — 代號與所屬市場。
• announcement_date — 公司公告這次配息的日期。
• cash_dividend — 每股現金股利。
• stock_dividend — 每股股票股利，單位是面額金額，不是比率（見下方）。
• ex_dividend_date、ex_rights_date — 除息日與除權日，可能只有其中一個。
• record_date、payment_date — 停止過戶基準日與現金發放日。
• dividend_type、fiscal_period、event_status — 配息種類、所屬期間、事件狀態。

雷：stock_dividend 是每股金額，不是配股率

台股面額多為每股 10 元，所以 stock_dividend = 1 代表每股配發面額 1 元的股票，換算成配股率是 10%（每 1000 股配 100 股），不是 1%，也不是每股配 1 股。直接把這個數字當成比率去乘持股數，算出來的股數會差一個數量級。

配息高不等於報酬高

除息當天股價會先扣掉配息，那不是下跌。真正拿到的報酬要看有沒有填息——也就是股價有沒有漲回除息前的價位。要算含息報酬請用還原股價，不要拿原始收盤價算。

Common questions