Building an AI agent? Start with /llms.txt for the full site index.
Companies & Events
MOPS (material announcements) classified into an event taxonomy (,, …) with the announcement subject, date/time, a rule version, and a classification confidence score. Not a forecast, not a recommendation.
GET /v2/datasets/major-event-taxonomyThis dataset is in build and not yet queryable via the API. The coverage and honest limitations below are the real database state; it moves off "Building" once serving lands (targeted 8/1).
| Field | Type | Description |
|---|---|---|
event_class | enum | ////… |
subject | text | verbatim subject |
event_time | time | |
confidence | ratio | classifier confidence (type, not impact) |
rule_version | text | mops_taxonomy_v1 |
1,017,099 rows, 2005-01-01..2026-07-18. event_class is a rule-based classification (rule_version=mops_taxonomy_v1) with a confidence score — it is a label of the announcement TYPE, not a judgement of impact. subject is the verbatim subject. Some announcements are corrections/updates of earlier ones.
A real response from this endpoint. Rows are returned under "data", and provenance is carried in the shape shown below — it is not identical across datasets, so read this page's rather than assuming another's.
{ "dataset_id": "major-event-taxonomy", "row_count": 3, "data": [ { "ticker": "6176", "event_date": "2026-07-17", "event_time": "16:33:29", "subject": "<Chinese value - see the zh page>", "market": "TW", "event_class": "<Chinese value - see the zh page>", "confidence": 0.95 }, { "ticker": "8277", "event_date": "2026-07-17", "event_time": "15:35:08", "subject": "<Chinese value - see the zh page>", "market": "TW", "event_class": "<Chinese value - see the zh page>", "confidence": 0.95 }, { "ticker": "1304", "event_date": "2026-07-17", "event_time": "16:26:36", "subject": "<Chinese value - see the zh page>", "market": "TW", "event_class": "<Chinese value - see the zh page>", "confidence": 0.95 } ]}Captured from the live API on 2026-07-20.
Chinese data values are shown as a marker here so this page stays in English; the /zh page shows them verbatim.
curl "https://api.twmarketdata.com/v2/datasets/major-event-taxonomy?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/major-event-taxonomy", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])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/major-event-taxonomy", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)This endpoint is GET /v2/datasets/major-event-taxonomy. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.