EN 登入註冊

AI agent？先讀 /llms.txt 取得全站索引。

公司與事件

公告資訊

提供台股公司的公告與揭露事件資料，適合用於事件追蹤、研究流程與訊號整合。

GET/v2/datasets/issuer-announcements

Overview

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

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

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

覆蓋範圍

標的數	起始年	更新時點	含已下市
尚未提供（coming）	尚未提供（coming）	尚未提供（coming）	coming

數字為 DB 實測；未列者以 docs coverage 為準（coming），不逐格編造。

Request

使用此 endpoint 時，建議：

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。

限制與注意

覆蓋非全市場、全期間；實際範圍以上方覆蓋小表與回應中的 data_gaps 為準。
資料有缺會如實標記，不以推測值補洞。
本平台聚焦日頻與基本面資料；不提供即時報價、盤中分K與加密貨幣。
TWSE 為 verified baseline；TPEx 歷史深度與還原股價目前為 beta / deferred，逐集標示。
查詢不支援 as_of 參數（列於路線圖）；point-in-time 請以各列的 knowledge_date 自行過濾，該日期保守設為法定申報截止日。日線價格不帶此欄位。

Plan Requirement

Free（限制）
Developer
Pro
Enterprise

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

請求與回應

請求範例

curl --request GET \  --url "https://api.twmarketdata.com/v2/datasets/issuer-announcements?symbol=2330&limit=20" \  --header "X-API-Key: your_api_key_here"

狀態碼

成功回傳公告資料

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    }  }}