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/events

Overview

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

這類資料的特性包括：

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

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	查詢結束日期。
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 與時間對齊邏輯。

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/events?symbol=2330&start_date=2026-01-01&end_date=2026-04-30&limit=20" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳事件資料

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

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

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

欄位

型別

Required

說明

symbol

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 與時間對齊邏輯。

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.