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/issuer-announcements

Overview

公告資訊 API 提供公司對外揭露公告資料，適合用於事件追蹤、披露監控與研究流程。

此 endpoint 為 productized public route，查詢參數與回應契約以 backend runtime 為準。

追蹤單一公司的公告歷史
建立重大揭露事件時間線
搭配價格與財務資料做事件對照分析
作為監控與研究流程的官方披露來源

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.

Query Parameters

欄位	型別	Required	說明
symbol	string	yes	股票代碼，用於查詢單一公司公告資料。
date_from	string	no	查詢起始日期（YYYY-MM-DD）。
date_to	string	no	查詢結束日期（YYYY-MM-DD）。
category	string	no	公告分類過濾。
limit	integer	no	回傳筆數限制。
offset	integer	no	分頁偏移。
sort_by	string	no	排序欄位，固定為 announcement_date。
sort_order	string	no	排序方向：asc 或 desc。

Response Shape

回應為 canonical envelope 格式，頂層包含 api_version、endpoint、dataset、query、meta、envelope。

{  "api_version": "v2",  "endpoint": "/v2/datasets/issuer-announcements",  "request_id": "req_9af2d5b1c321",  "plan_id": "pro",  "dataset": "issuer_announcements",  "query": {    "ticker": "2330",    "date_from": "2026-04-01",    "date_to": "2026-04-22",    "category": "financial",    "limit": 20,    "offset": 0,    "sort_by": "announcement_date",    "sort_order": "desc"  },  "meta": {    "rows_returned": 1  },  "envelope": {    "api_version": "v2",    "dataset": "issuer_announcements",    "release_date": "2026-04-22",    "request_context": {      "ticker": "2330",      "as_of_date": "2026-04-22",      "family": "issuer_official_news",      "dataset_view": "issuer_announcements_v1"    },    "data": [      {        "ticker": "2330",        "announcement_date": "2026-04-22",        "category": "financial",        "title": "公告本公司董事會通過第一季財務報告",        "source_url": "https://mops.twse.com.tw/..."      }    ],    "quality": {      "freshness_state": "fresh",      "freshness_as_of": "2026-04-22",      "completeness_ratio": 1,      "quality_status": "ready"    },    "lineage": {      "source_role": "canonical",      "selected_source": "mops_official"    },    "error": {      "error_code": null,      "error_message": null,      "blocking_gate": null    }  }}

Field 說明

欄位路徑	型別	說明
dataset	string	資料集識別，固定為 issuer_announcements。
query.ticker	string	本次查詢使用的股票代碼。
meta.rows_returned	integer	回傳資料筆數。
envelope.data[].ticker	string	股票代碼。
envelope.data[].announcement_date	string	公告日期。
envelope.data[].category	string\|null	公告分類。
envelope.data[].title	string\|null	公告標題。
envelope.data[].source_url	string\|null	來源連結。
envelope.lineage.source_role	string	來源角色（canonical）。

Usage Notes / 使用建議

此頁為 productized endpoint，請勿與 legacy 回應格式混用。
若要做事件整合分析，可搭配 `/v2/datasets/events` 與 `/v2/datasets/structured-events`。
若需要較高頻價格對照，建議搭配 TWSE/TPEx 日線價格 endpoint。

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/issuer-announcements?symbol=2330&limit=20" \  --header "X-API-Key: your_api_key_here"

Status codes

成功回傳公告資料

JSON

{  "api_version": "v2",  "endpoint": "/v2/datasets/issuer-announcements",  "request_id": "req_9af2d5b1c321",  "plan_id": "pro",  "dataset": "issuer_announcements",  "query": {    "ticker": "2330",    "date_from": "2026-04-01",    "date_to": "2026-04-22",    "category": "financial",    "limit": 20,    "offset": 0,    "sort_by": "announcement_date",    "sort_order": "desc"  },  "meta": {    "rows_returned": 1  },  "envelope": {    "api_version": "v2",    "dataset": "issuer_announcements",    "release_date": "2026-04-22",    "request_context": {      "ticker": "2330",      "as_of_date": "2026-04-22",      "family": "issuer_official_news",      "dataset_view": "issuer_announcements_v1"    },    "data": [      {        "ticker": "2330",        "announcement_date": "2026-04-22",        "category": "financial",        "title": "公告本公司董事會通過第一季財務報告",        "source_url": "https://mops.twse.com.tw/..."      }    ],    "quality": {      "freshness_state": "fresh",      "freshness_as_of": "2026-04-22",      "completeness_ratio": 1,      "quality_status": "ready"    },    "lineage": {      "source_role": "canonical",      "selected_source": "mops_official"    },    "error": {      "error_code": null,      "error_message": null,      "blocking_gate": null    }  }}

Overview

公告資訊 API 提供公司對外揭露公告資料，適合用於事件追蹤、披露監控與研究流程。

此 endpoint 為 productized public route，查詢參數與回應契約以 backend runtime 為準。

追蹤單一公司的公告歷史

建立重大揭露事件時間線

搭配價格與財務資料做事件對照分析

作為監控與研究流程的官方披露來源

Instruments

Start year

Update timing

Includes delisted

Not yet available (coming)

coming

Query Parameters

欄位	型別	Required	說明
symbol	string	yes	股票代碼，用於查詢單一公司公告資料。
date_from	string	no	查詢起始日期（YYYY-MM-DD）。
date_to	string	no	查詢結束日期（YYYY-MM-DD）。
category	string	no	公告分類過濾。
limit	integer	no	回傳筆數限制。
offset	integer	no	分頁偏移。
sort_by	string	no	排序欄位，固定為 announcement_date。
sort_order	string	no	排序方向：asc 或 desc。

Response Shape

回應為 canonical envelope 格式，頂層包含 api_version、endpoint、dataset、query、meta、envelope。

{  "api_version": "v2",  "endpoint": "/v2/datasets/issuer-announcements",  "request_id": "req_9af2d5b1c321",  "plan_id": "pro",  "dataset": "issuer_announcements",  "query": {    "ticker": "2330",    "date_from": "2026-04-01",    "date_to": "2026-04-22",    "category": "financial",    "limit": 20,    "offset": 0,    "sort_by": "announcement_date",    "sort_order": "desc"  },  "meta": {    "rows_returned": 1  },  "envelope": {    "api_version": "v2",    "dataset": "issuer_announcements",    "release_date": "2026-04-22",    "request_context": {      "ticker": "2330",      "as_of_date": "2026-04-22",      "family": "issuer_official_news",      "dataset_view": "issuer_announcements_v1"    },    "data": [      {        "ticker": "2330",        "announcement_date": "2026-04-22",        "category": "financial",        "title": "公告本公司董事會通過第一季財務報告",        "source_url": "https://mops.twse.com.tw/..."      }    ],    "quality": {      "freshness_state": "fresh",      "freshness_as_of": "2026-04-22",      "completeness_ratio": 1,      "quality_status": "ready"    },    "lineage": {      "source_role": "canonical",      "selected_source": "mops_official"    },    "error": {      "error_code": null,      "error_message": null,      "blocking_gate": null    }  }}

Field 說明

欄位路徑	型別	說明
dataset	string	資料集識別，固定為 issuer_announcements。
query.ticker	string	本次查詢使用的股票代碼。
meta.rows_returned	integer	回傳資料筆數。
envelope.data[].ticker	string	股票代碼。
envelope.data[].announcement_date	string	公告日期。
envelope.data[].category	string\|null	公告分類。
envelope.data[].title	string\|null	公告標題。
envelope.data[].source_url	string\|null	來源連結。
envelope.lineage.source_role	string	來源角色（canonical）。

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.

{ "api_version": "v2", "endpoint": "/v2/datasets/issuer-announcements", "request_id": "req_9af2d5b1c321", "plan_id": "pro", "dataset": "issuer_announcements", "query": { "ticker": "2330", "date_from": "2026-04-01", "date_to": "2026-04-22", "category": "financial", "limit": 20, "offset": 0, "sort_by": "announcement_date", "sort_order": "desc" }, "meta": { "rows_returned": 1 }, "envelope": { "api_version": "v2", "dataset": "issuer_announcements", "release_date": "2026-04-22", "request_context": { "ticker": "2330", "as_of_date": "2026-04-22", "family": "issuer_official_news", "dataset_view": "issuer_announcements_v1" }, "data": [ { "ticker": "2330", "announcement_date": "2026-04-22", "category": "financial", "title": "公告本公司董事會通過第一季財務報告", "source_url": "https://mops.twse.com.tw/..." } ], "quality": { "freshness_state": "fresh", "freshness_as_of": "2026-04-22", "completeness_ratio": 1, "quality_status": "ready" }, "lineage": { "source_role": "canonical", "selected_source": "mops_official" }, "error": { "error_code": null, "error_message": null, "blocking_gate": null } }}