Building an AI agent? Start with /llms.txt for the full site index.
Companies & Events
Company risk events (preview) — attention, altered-trading and other risk flags raised on listed securities by the exchange, normalized into one stream.
GET /v2/datasets/company-risk-eventscompany-risk-events returns one row per risk flag raised on a security — for example attention or altered-trading notices — normalized across the official TWSE / TPEx announcements. This is a private-beta preview: coverage is partial and the schema may change, so numbers here are provisional. Each row carries its source role and lineage back to the upstream disclosure.
| Field | Type | Description |
|---|---|---|
symbol | string | Ticker. |
event_date | string | Date the flag was raised. |
risk_type | string | Normalized risk type (e.g. attention, altered_trading). |
description | string | Risk-event description as disclosed. |
source_role | string | Canonical source role (official_twse_risk_event). |
lineage | object | Upstream authority + release for the flag. |
| Rows | 1,709 |
| Window | 2012-01-12 – 2026-06-30 |
| Grade | Reference |
TODO — no real response has been captured for this dataset yet. It needs an entitled API key, or its required parameters are not yet known. Rather than show an example nobody has observed, this section stays empty.
curl "https://api.twmarketdata.com/v2/datasets/company-risk-events?symbol=2330" \ -H "X-API-Key: sk_live_..."| Parameter | Required | Type | Description |
|---|---|---|---|
symbol | Yes | string | Ticker, e.g. 2330. |
start_date | No | string (YYYY-MM-DD) | Start of the query range. |
end_date | No | string (YYYY-MM-DD) | End of the query range. |
limit | No | integer | Maximum rows to return. |
A first call:
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())With a date-range filter:
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())This endpoint is GET /v2/datasets/company-risk-events. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.