公司與事件

事件日曆

提供台股公司的事件型資料，適合用於建立事件時間線、事件追蹤與跨資料集分析。

GET/v2/datasets/events

Overview#

事件日曆 API 提供可按時間檢索的公司事件資料，適合用於研究流程、監控系統與事件驅動分析。

這類資料的特性包括：

以時間為核心索引
適合建立事件時間線
可與價格、財報、公告等資料一起使用
查詢特定公司在一段期間內的重要事件
建立事件時間線並觀察前後市場反應
將事件資料與價格或月營收資料整合分析
將事件節點作為 research pipeline 的標記層
提供 agent workflow 可引用的事件 context
事件日曆適合用於時間序列上的事件檢視；相較公告資訊頁面，這一頁更強調事件時間、範圍查詢與時間線用途。

Request#

使用此 endpoint 時，建議：

Query Parameters#

欄位	型別	Required	說明
ticker	string	yes	股票代碼，用於查詢單一公司的事件資料。
start_date	string	no	查詢起始日期。
end_date	string	no	查詢結束日期。
limit	integer	no	回傳筆數限制。
offset	integer	no	分頁偏移。

Response Shape#

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

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

Field 說明#

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

Usage Notes / 使用建議#

使用 ticker + event_date 作為主要識別組合。
若要與價格資料整合，應保留事件時間。
對長期研究建議先抓取後落地存放，不要重複高頻查詢。
若同時需要文本細節，應搭配公告資訊頁面一起使用。
若要做事件驅動策略，應先確認 freshness 與時間對齊邏輯。

Plan Requirement#

Free（限制）
Developer
Pro
Enterprise

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

請求與回應

請求範例

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/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:30:00+08:00",  "lineage": {    "source": "TWSE",    "ingested_at": "2026-04-22T10:30:05+08:00",    "trace_id": "events_2330_20260422"  },  "data": [    {      "ticker": "2330",      "event_date": "2026-04-18",      "event_type": "board_meeting",      "title": "董事會通過第一季財務報告",      "summary": "董事會決議通過 2026 年第一季財務報告。"    }  ]}

Overview#

事件日曆 API 提供可按時間檢索的公司事件資料，適合用於研究流程、監控系統與事件驅動分析。

這類資料的特性包括：

以時間為核心索引

適合建立事件時間線

可與價格、財報、公告等資料一起使用

查詢特定公司在一段期間內的重要事件

建立事件時間線並觀察前後市場反應

將事件資料與價格或月營收資料整合分析

將事件節點作為 research pipeline 的標記層

提供 agent workflow 可引用的事件 context

事件日曆適合用於時間序列上的事件檢視；相較公告資訊頁面，這一頁更強調事件時間、範圍查詢與時間線用途。

欄位

型別

Required

說明

ticker

string

yes

股票代碼，用於查詢單一公司的事件資料。

start_date

string

查詢起始日期。

end_date

string

查詢結束日期。

limit

integer

回傳筆數限制。

offset

integer

分頁偏移。

Response Shape#

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

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

Field 說明#

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

Usage Notes / 使用建議#

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

若要與價格資料整合，應保留事件時間。

對長期研究建議先抓取後落地存放，不要重複高頻查詢。

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

若要做事件驅動策略，應先確認 freshness 與時間對齊邏輯。