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

公司與事件

公司風險事件

公司風險事件（預覽）——交易所對上市櫃證券發布的注意、變更交易方法等風險標記，正規化為單一資料流。

參考來源: TWSE / TPEx·方案: pro·計費: 3 點·GET /v2/datasets/company-risk-events

總覽

company-risk-events 每筆對證券發布的風險標記回傳一列——例如注意或變更交易方法——跨官方 TWSE／TPEx 公告正規化。此為私測預覽：涵蓋為部分且結構可能變動，數字屬暫定。每列附來源角色與回溯上游揭露的 lineage。

欄位	型別	說明
`symbol`	string	股票代碼。
`event_date`	string	風險標記發布日。
`risk_type`	string	正規化風險類型（如 attention、altered_trading）。
`description`	string	揭露之風險事件描述。
`source_role`	string	正規來源角色（official_twse_risk_event）。
`lineage`	object	標記所屬的上游權威來源與發布。

涵蓋範圍

列數	1,709
涵蓋起訖	2012-01-12 至 2026-06-30
分級	參考

範例回應

TODO —— 尚未擷取到此資料集的真實回應（需要有權限的 API 金鑰，或其必填參數尚未確認）。寧可留白，也不顯示未經實測的範例。

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取回傳內容。

curl "https://api.twmarketdata.com/v2/datasets/company-risk-events?symbol=2330" \  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`symbol`	是	string	股票代碼，例如 2330。
`start_date`	否	string (YYYY-MM-DD)	查詢起始日期。
`end_date`	否	string (YYYY-MM-DD)	查詢結束日期。
`limit`	否	integer	回傳筆數上限。

Python 範例

第一個呼叫：

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/company-risk-events",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

帶日期區間篩選：

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/company-risk-events",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

OpenAPI

此端點為 GET /v2/datasets/company-risk-events。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

私測預覽：涵蓋為部分且結構在正式上線前可能變動——無標記應視為「未收錄」，而非「無風險」。
僅供參考，非法律或投資建議：風險標記反映交易所公告，不構成對公司的判斷——採取行動前請對照官方公告核實。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/company-risk-events?symbol=2330&start_date=2026-01-01&end_date=2026-06-30&limit=5" \  -H "X-API-Key: $TWMD_API_KEY"

以 X-API-Key 標頭認證，使用儀表板發放的 sk_live_ 金鑰。

回應

TODO —— 尚未擷取到此資料集的真實回應（需要有權限的金鑰，或其必填參數尚未確認）。寧可不顯示範例，也不編造。

本頁的分級徽章屬文件分級，並非回應欄位。

總覽

欄位	型別	說明
`symbol`	string	股票代碼。
`event_date`	string	風險標記發布日。
`risk_type`	string	正規化風險類型（如 attention、altered_trading）。
`description`	string	揭露之風險事件描述。
`source_role`	string	正規來源角色（official_twse_risk_event）。
`lineage`	object	標記所屬的上游權威來源與發布。

參數

必填

型別

說明

symbol

是

string

股票代碼，例如 2330。

start_date

否

string (YYYY-MM-DD)

查詢起始日期。

end_date

否

string (YYYY-MM-DD)

查詢結束日期。

limit

否

integer

回傳筆數上限。

Python 範例

第一個呼叫：

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/company-risk-events",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

帶日期區間篩選：

import requests # The full verified example — the same call with every supported filter set.resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/company-risk-events",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())