公司與事件

公司行動

提供會影響持有人權益與價格序列的公司行動資料，適合用於還原價格、報酬計算與事件調整流程。

GET/v2/datasets/corporate-actions

Overview#

公司行動 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

此 API 屬於 TW Market Data 資料集目錄。查看資料集總覽

請求與回應

請求範例

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/corporate-actions?ticker=2330&start_date=2024-01-01&end_date=2026-04-30&limit=20" \  --header "X-API-Key: your_api_key_here"

狀態碼

成功回傳公司行動資料

JSON

{  "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    }  ]}

Overview#

公司行動 API 提供與股東權益、持有部位與價格調整直接相關的事件資料，例如股利、分割、減資、增資或其他需要納入資料處理邏輯的公司行為。

這類資料和一般公告不同。

它的重點不在於文字揭露本身，而在於是否需要影響價格序列、持有報酬、部位計算或研究樣本的解讀方式。

典型用途包括：

建立還原價格與總報酬序列

在回測中處理股利、分割與其他權益事件

將公司行動作為資料清洗與正規化流程的一部分

檢查特定期間內是否有會影響比較基準的公司事件

與歷史價格、股利資料或公司事件資料一起交叉驗證

如果事件日曆偏向發生了什麼，公司行動更偏向這個事件是否需要改變資料處理方式。

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 作為主要識別組合。

若要做還原價格，應與價格資料搭配使用。

若要做總報酬或持有報酬分析，應保留現金與比例類欄位。

對長期研究建議先完整抓取並落地，不要反覆即時查詢。

若只需要一般事件追蹤，應改用事件日曆或公告資訊頁面。