Building an AI agent? Start with /llms.txt for the full site index.
Market Structure & Reference
Warrants reference — the master record for each listed warrant (identity, underlying, type and key contract terms).
GET /v2/datasets/warrants-referencewarrants-reference is a reference dataset: one active record per listed warrant, used to resolve a warrant code to its underlying, type and contract terms. It is an active snapshot of currently listed warrants, not a price or trading time series.
| Field | Type | Description |
|---|---|---|
symbol | string | Warrant code. |
warrant_name | string | Warrant name. |
underlying_symbol | string | Underlying security ticker. |
warrant_type | string | Call / put and style. |
last_trading_date | string | Last trading date of the warrant. |
source_role | string | official_twse_warrant_master. |
| Rows | 51,570 |
| Window | Reference data, no time series |
| Grade | Reference |
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": "warrants_reference", "request_context": { "scope": "warrants_reference_latest_snapshot_only", "coverage_type": "latest_snapshot_only", "filters": { "warrant_code": null, "market": null, "underlying_ticker": null, "issuer": null, "warrant_type": null, "source_family": null, "limit": 50 } }, "quality": { "row_count": 50, "warrant_count": 50, "sensitive_fields_exposed": false }, "lineage": { "source_providers": [ "tpex_official" ], "source_roles": [ "official_tpex_warrant_issue" ], "source_families": [ "tpex_warrant_issue" ] }, "error": null, "data": [ { "warrant_code": "700008", "market": "TPEx", "underlying_ticker": "4749", "issuer": null, "warrant_type": "<Chinese value - see the zh page>", "strike_price": null, "exercise_ratio": null, "listing_date": "2025-10-01", "expiry_date": "2026-06-30", "settlement_style": null, "exercise_style": null, "source_provider": "tpex_official", "source_role": "official_tpex_warrant_issue", "source_family": "tpex_warrant_issue", "lineage": { "depth": "latest_snapshot_only", "source_name": "tpex_warrant_issue" }, "data_gaps": [ "issuer_not_provided_by_source" ], "not_investment_advice": true }, { "warrant_code": "700018", "market": "TPEx", "underlying_ticker": "3324", "issuer": null, "warrant_type": "<Chinese value - see the zh page>", "strike_price": null, "exercise_ratio": null, "listing_date": "2025-10-01", "expiry_date": "2026-06-30", "settlement_style": null, "exercise_style": null, "source_provider": "tpex_official", "source_role": "official_tpex_warrant_issue", "source_family": "tpex_warrant_issue", "lineage": { "depth": "latest_snapshot_only", "source_name": "tpex_warrant_issue" }, "data_gaps": [ "issuer_not_provided_by_source" ], "not_investment_advice": true } ], "data_count": 50, "known_gaps": [ "latest_snapshot_only", "reference_only_not_daily_quotes", "no_daily_quote_coverage" ], "warnings": [ "not_investment_advice" ], "not_investment_advice": true, "envelope": { "dataset_id": "warrants_reference", "scope": "warrants_reference_latest_snapshot_only", "row_count": 50 }}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/warrants-reference?symbol=2330" \ -H "X-API-Key: sk_live_..."| Parameter | Required | Type | Description |
|---|---|---|---|
symbol | No | string | Ticker to filter to a single security. |
limit | No | integer | Maximum rows to return. |
A first call:
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/warrants-reference", 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/warrants-reference", 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/warrants-reference. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.