公司與事件
公司行動
提供會影響持有人權益與價格序列的公司行動資料，適合用於還原價格、報酬計算與事件調整流程。
GET
/v2/datasets/corporate-actionsOverview#
公司行動 API 提供與股東權益、持有部位與價格調整直接相關的事件資料，例如股利、分割、減資、增資或其他需要納入資料處理邏輯的公司行為。
這類資料和一般公告不同。
它的重點不在於文字揭露本身，而在於是否需要影響價格序列、持有報酬、部位計算或研究樣本的解讀方式。
典型用途包括：
- 建立還原價格與總報酬序列
- 在回測中處理股利、分割與其他權益事件
- 將公司行動作為資料清洗與正規化流程的一部分
- 檢查特定期間內是否有會影響比較基準的公司事件
- 與歷史價格、股利資料或公司事件資料一起交叉驗證
- 如果事件日曆偏向發生了什麼，公司行動更偏向這個事件是否需要改變資料處理方式。
Request#
使用此 endpoint 時，建議：
Query Parameters#
| 欄位 | 型別 | Required | 說明 |
|---|---|---|---|
| ticker | string | yes | 股票代碼，用於查詢單一公司的公司行動資料。 |
| start_date | string | no | 查詢起始日期。 |
| end_date | string | no | 查詢結束日期。 |
| action_type | string | no | 公司行動類型（若目前 schema 有正式支持）。 |
| limit | integer | no | 回傳筆數限制。 |
| offset | integer | no | 分頁偏移。 |
Response Shape#
所有回應遵循一致結構，包含 dataset、source_role、freshness、lineage、data。
{
"dataset": "corporate_actions",
"source_role": "canonical",
"freshness": "2026-04-22T11:00:00+08:00",
"lineage": {
"source": "TWSE",
"ingested_at": "2026-04-22T11:00:05+08:00",
"trace_id": "corporate_actions_2330_20260422"
},
"data": [
{
"ticker": "2330",
"event_date": "2025-06-12",
"action_type": "cash_dividend",
"title": "現金股利除息",
"cash_amount": 3.5
}
]
}Field 說明#
| 欄位路徑 | 型別 | 說明 |
|---|---|---|
| data[].ticker | string | 股票代碼。 |
| data[].event_date | string | 公司行動生效或公告日期。 |
| data[].action_type | string | 公司行動類型。 |
| data[].title | string | 事件標題。 |
| data[].cash_amount | number|null | 現金配發或相關金額（若目前 schema 有）。 |
| data[].ratio | number|string|null | 配發比例、分割比例或相關比率（若目前 schema 有）。 |
| data[].source_url | string|null | 原始來源連結（若目前 schema 有）。 |
| source_role | string | 資料來源角色。 |
| freshness | string | 資料更新時間。 |
| lineage.trace_id | string | 可追蹤資料處理鏈路。 |
Usage Notes / 使用建議#
- 使用 ticker + event_date + action_type 作為主要識別組合。
- 若要做還原價格，應與價格資料搭配使用。
- 若要做總報酬或持有報酬分析，應保留現金與比例類欄位。
- 對長期研究建議先完整抓取並落地，不要反覆即時查詢。
- 若只需要一般事件追蹤，應改用事件日曆或公告資訊頁面。
Plan Requirement#
- Free（限制）
- Developer
- Pro
- Enterprise