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

Overview

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

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

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

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	查詢結束日期。
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。
若同時需要原始文本細節，應搭配公告資訊頁面一起使用。
若只需要時間線檢視，可搭配事件日曆頁面使用。

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/structured-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: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 中的結構化事件層

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

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

Query Parameters

欄位	型別	Required	說明
symbol	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。

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

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

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.