公司與事件
事件日曆
提供台股公司的事件型資料，適合用於建立事件時間線、事件追蹤與跨資料集分析。
GET
/v2/datasets/eventsOverview#
事件日曆 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