如何看市場狀態

從官方 TWSE 指數資料讀當日大盤點位與漲跌。

目標

看今天大盤收在哪:加權指數（TAIEX）點位與當日漲跌,來自官方 TWSE 指數資料。

步驟 1 — 取大盤指數

請求 market-index 並篩選 TAIEX。真實請求:

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"

步驟 2 — 讀點位與漲跌

真實 200 回應（一筆,TAIEX 於 2026-07-17）。注意此資料集信封為 { dataset_id, row_count, items },欄位為巢狀（此處省略中文指數名以保持範例純 ASCII,index_code 即可識別）:

index_level.value — 指數點位（42,671.27）。
daily_change.points／daily_change.return_pct — 當日漲跌（-2,953.71 點,-6.47%）。
index_identity.index_code 為 TWSE_TAIEX（回應另含中文 index_name「發行量加權股價指數」）。

{  "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 }    }  ]}

漲跌家數（市場廣度）

TODO — market-breadth 端點需要 market 過濾,且對實測窗口回空,故此處先不放範例（不編造),待資料集復驗後補真回應。

英文為語義改寫,非機器翻譯。

步驟 2 — 讀點位與漲跌

index_level.value — 指數點位（42,671.27）。

daily_change.points／daily_change.return_pct — 當日漲跌（-2,953.71 點,-6.47%）。

index_identity.index_code 為 TWSE_TAIEX（回應另含中文 index_name「發行量加權股價指數」）。

{  "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 }    }  ]}