Building an AI agent? Start with /llms.txt for the full site index.

公司與事件

公司行動

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

This documentation page is currently available in Chinese only; English versions are coming soon.

GET/v2/datasets/corporate-actions

Overview

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

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

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

典型用途包括：

建立還原價格與總報酬序列
在回測中處理股利、分割與其他權益事件
將公司行動作為資料清洗與正規化流程的一部分
檢查特定期間內是否有會影響比較基準的公司事件
與歷史價格、股利資料或公司事件資料一起交叉驗證
如果事件日曆偏向發生了什麼，公司行動更偏向這個事件是否需要改變資料處理方式。

Coverage

Instruments	Start year	Update timing	Includes delisted
Not yet available (coming)	Not yet available (coming)	Not yet available (coming)	coming

Figures are measured from the DB; unlisted fields defer to docs coverage (coming) — we don't fabricate cell by cell.

Request

使用此 endpoint 時，建議：

Query Parameters

欄位	型別	Required	說明
symbol	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 作為主要識別組合。
若要做還原價格，應與價格資料搭配使用。
若要做總報酬或持有報酬分析，應保留現金與比例類欄位。
對長期研究建議先完整抓取並落地，不要反覆即時查詢。
若只需要一般事件追蹤，應改用事件日曆或公告資訊頁面。

Limitations & notes

Coverage is not the full market or full history; the actual range is defined by the coverage table above and the data_gaps in the response.
Missing data is flagged honestly — we don't fill gaps with estimated values.
The platform focuses on daily-frequency and fundamental data; it does not provide real-time quotes, intraday bars, or cryptocurrencies.
TWSE is the verified baseline; TPEx history depth and adjusted prices are currently beta / deferred, flagged per dataset.

Plan Requirement

Free（限制）
Developer
Pro
Enterprise

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

請求與回應

Request example

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

Status codes

成功回傳公司行動資料

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