How to check market status

Goal

See where the market closed today: the TAIEX level and its daily change, from the official TWSE index feed.

Step 1 — Fetch the benchmark index

Request market-index filtered to the TAIEX. A real request:

curl -H "X-API-Key: sk_live_..." \  "https://api.twmarketdata.com/v2/datasets/market-index?symbol=TAIEX&start_date=2026-07-14&end_date=2026-07-18"

Step 2 — Read the level and change

A real 200 response (one item, TAIEX on 2026-07-17). Note this dataset's envelope is { dataset_id, row_count, items } and the fields are nested (the Chinese index name is omitted here to keep the sample ASCII — index_code identifies it):

• index_level.value — the index level (42,671.27).
• daily_change.points / daily_change.return_pct — the day's move (-2,953.71 points, -6.47%).
• index_identity.index_code is TWSE_TAIEX (the response also carries the Chinese index_name — see the zh page).

{  "dataset_id": "market_index",  "row_count": 4,  "items": [    {      "index_identity": { "index_code": "TWSE_TAIEX", "index_type": "price" },      "market_identity": { "as_of_date": "2026-07-17", "source_role": "official_twse_mi_index" },      "index_level": { "value": 42671.27 },      "daily_change": { "points": -2953.71, "return_pct": -6.47 }    }  ]}

Advancers / decliners (breadth)

TODO — the market-breadth endpoint requires a market filter and returned no rows for the windows tested against the live API, so a real example is not shown here yet rather than a fabricated one. It will be filled once the dataset is re-verified.