Building an AI agent? Start with /llms.txt for the full site index.
Companies & Events
Coming soon — a unified corporate events calendar across TWSE / TPEx / MOPS. The underlying table exists, but the serving endpoint returns no rows yet, so this dataset is being finished before it goes live.
GET /v2/datasets/eventsevents will return one row per company event with a normalized type and its source, merging announcements from multiple official venues into one stream. The serving endpoint currently returns no rows (the aggregation is not wired through yet), so the fields below are the planned schema, not a served response. It will move off "Building" once the endpoint serves the table.
| Field | Type | Description |
|---|---|---|
symbol | string | Ticker. |
event_date | string | Event / announcement date. |
event_type | string | Normalized event type. |
title | string | Event title. |
source_role | string | official_mops_major_event. |
TODO — exact event counts and the coverage window are pending a measured snapshot; the source is the official MOPS / TWSE / TPEx announcement venues (present through the latest disclosure).
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/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/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/events", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())This endpoint is GET /v2/datasets/events. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.