公司與事件

結構化事件

提供經過整理與標準化的公司事件資料，適合用於事件驅動研究、篩選條件建構與自動化流程。

GET/v2/datasets/structured-events

Overview#

結構化事件 API 提供已整理為可分析欄位的事件資料，適合用於研究、監控系統與事件驅動 workflow。

相較於原始公告資訊，這一頁更強調：

事件欄位已被結構化整理
更適合直接做篩選、分類與統計
便於與價格、財報、月營收等資料整合
依事件類型篩選公司事件
建立事件驅動研究流程
將事件作為回測或監控條件
與價格反應或基本面變化進行對照
作為 agent workflow 中的結構化事件層
如果公告資訊偏向原始文本入口，結構化事件則更適合直接作為分析資料使用。

Request#

使用此 endpoint 時，建議：

Query Parameters#

欄位	型別	Required	說明
ticker	string	yes	股票代碼，用於查詢單一公司的結構化事件資料。
start_date	string	no	查詢起始日期。
end_date	string	no	查詢結束日期。
event_type	string	no	事件類型（若目前 schema 有正式支持）。
limit	integer	no	回傳筆數限制。
offset	integer	no	分頁偏移。

Response Shape#

所有回應遵循一致結構，包含 dataset、source_role、freshness、lineage、data。

{  "dataset": "events",  "source_role": "canonical",  "freshness": "2026-04-22T10:45:00+08:00",  "lineage": {    "source": "TWSE",    "ingested_at": "2026-04-22T10:45:05+08:00",    "trace_id": "structured_events_2330_20260422"  },  "data": [    {      "ticker": "2330",      "event_date": "2026-04-18",      "event_type": "financial_report",      "title": "董事會通過第一季財務報告",      "summary": "董事會決議通過 2026 年第一季財務報告。"    }  ]}

Field 說明#

欄位路徑	型別	說明
data[].ticker	string	股票代碼。
data[].event_date	string	事件日期。
data[].event_type	string	結構化後的事件類型。
data[].title	string	事件標題。
data[].summary	string\|null	事件摘要（若目前 schema 有）。
data[].importance	string\|null	事件重要性或事件層級（若目前 schema 有正式對外欄位）。
data[].source_url	string\|null	原始來源連結（若目前 schema 有）。
source_role	string	資料來源角色。
freshness	string	資料更新時間。
lineage.trace_id	string	可追蹤資料處理鏈路。

Usage Notes / 使用建議#

使用 ticker + event_date + event_type 作為主要識別組合。
若要做事件驅動研究，應保留事件時間與事件類型。
若資料將用於回測，建議先落地並保留 freshness / lineage。
若同時需要原始文本細節，應搭配公告資訊頁面一起使用。
若只需要時間線檢視，可搭配事件日曆頁面使用。

Plan Requirement#

Free（限制）
Developer
Pro
Enterprise

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

請求與回應

請求範例

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

狀態碼

成功回傳結構化事件資料

JSON

{  "dataset": "events",  "source_role": "canonical",  "freshness": "2026-04-22T10:45:00+08:00",  "lineage": {    "source": "TWSE",    "ingested_at": "2026-04-22T10:45:05+08:00",    "trace_id": "structured_events_2330_20260422"  },  "data": [    {      "ticker": "2330",      "event_date": "2026-04-18",      "event_type": "financial_report",      "title": "董事會通過第一季財務報告",      "summary": "董事會決議通過 2026 年第一季財務報告。"    }  ]}

Overview#

結構化事件 API 提供已整理為可分析欄位的事件資料，適合用於研究、監控系統與事件驅動 workflow。

相較於原始公告資訊，這一頁更強調：

事件欄位已被結構化整理

更適合直接做篩選、分類與統計

便於與價格、財報、月營收等資料整合

依事件類型篩選公司事件

建立事件驅動研究流程

將事件作為回測或監控條件

與價格反應或基本面變化進行對照

作為 agent workflow 中的結構化事件層

如果公告資訊偏向原始文本入口，結構化事件則更適合直接作為分析資料使用。

Query Parameters#

欄位	型別	Required	說明
ticker	string	yes	股票代碼，用於查詢單一公司的結構化事件資料。
start_date	string	no	查詢起始日期。
end_date	string	no	查詢結束日期。
event_type	string	no	事件類型（若目前 schema 有正式支持）。
limit	integer	no	回傳筆數限制。
offset	integer	no	分頁偏移。

Response Shape#

所有回應遵循一致結構，包含 dataset、source_role、freshness、lineage、data。

{  "dataset": "events",  "source_role": "canonical",  "freshness": "2026-04-22T10:45:00+08:00",  "lineage": {    "source": "TWSE",    "ingested_at": "2026-04-22T10:45:05+08:00",    "trace_id": "structured_events_2330_20260422"  },  "data": [    {      "ticker": "2330",      "event_date": "2026-04-18",      "event_type": "financial_report",      "title": "董事會通過第一季財務報告",      "summary": "董事會決議通過 2026 年第一季財務報告。"    }  ]}

Field 說明#

欄位路徑	型別	說明
data[].ticker	string	股票代碼。
data[].event_date	string	事件日期。
data[].event_type	string	結構化後的事件類型。
data[].title	string	事件標題。
data[].summary	string\|null	事件摘要（若目前 schema 有）。
data[].importance	string\|null	事件重要性或事件層級（若目前 schema 有正式對外欄位）。
data[].source_url	string\|null	原始來源連結（若目前 schema 有）。
source_role	string	資料來源角色。
freshness	string	資料更新時間。
lineage.trace_id	string	可追蹤資料處理鏈路。

Usage Notes / 使用建議#

使用 ticker + event_date + event_type 作為主要識別組合。

若要做事件驅動研究，應保留事件時間與事件類型。

若資料將用於回測，建議先落地並保留 freshness / lineage。

若同時需要原始文本細節，應搭配公告資訊頁面一起使用。

若只需要時間線檢視，可搭配事件日曆頁面使用。