Building an AI agent? Start with /llms.txt for the full site index.
Market & Prices
Ex-rights / ex-dividend price adjustment factors per stock per event — the back-adjustment factor and reference price from the official TWSE TWT49U calculation.
GET /v2/datasets/price-enhancedprice-enhanced returns one row per stock per ex-rights / ex-dividend event with the adjustment factor used to back-adjust historical prices, the pre-event close and the reference price, sourced from the official TWSE TWT49U report. It is the correct source for building a continuous back-adjusted price series — it is not an OHLCV or derived-indicator dataset.
| Field | Type | Description |
|---|---|---|
symbol | string | Ticker. |
date | string | Ex-rights / ex-dividend date. |
event_type | string | Corporate-action type (ex-dividend / ex-rights / both). |
factor | number | Price adjustment (back-adjustment) factor for the event. |
pre_event_close | number | Closing price the trading day before the event. |
reference_price | number | Ex-rights / ex-dividend reference price. |
source_role | string | Canonical source role (official_twse_twt49u). |
TODO — exact row / symbol counts and the coverage window are pending a measured snapshot; the source is the official TWSE TWT49U ex-rights/dividend report (present through the latest event). No counts are shown rather than fabricated ones.
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/price-enhanced?ticker=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/price-enhanced", params={"ticker": "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/price-enhanced", params={"ticker": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())This endpoint is GET /v2/datasets/price-enhanced. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.