Index classification

Overview

index-classification is a reference dataset: one record per index describing where it sits in the TWSE index hierarchy. Use it to resolve an index code to its name and category, or to enumerate the indices in a family. It is a lookup snapshot, not a time series of levels.

Coverage

Example response

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.

Getting started

1. Put your key in the X-API-Key header.
2. Add query parameters (symbol, date range, limit).
3. Send the request and read the returned payload.

curl "https://api.twmarketdata.com/v2/datasets/index-classification?symbol=2330" \  -H "X-API-Key: sk_live_..."

Filtering

Python

A first call:

import requests resp = requests.get(    "https://api.twmarketdata.com/v2/datasets/index-classification",    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/index-classification",    params={"symbol": "2330"},    headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json())

OpenAPI

This endpoint is GET /v2/datasets/index-classification. The full machine-readable schema (parameters, security, response envelope) lives in the OpenAPI spec.

Notes & limitations

• Reference lookup snapshot — not a time series; it does not reconstruct how an index was classified at a past date.