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)

The market-breadth endpoint requires a market filter, and it returned no rows for the windows tested against the live API — so no example response is shown here rather than a fabricated one.