指數分類

Overview#

指數分類 API 提供指數層級的分類事實欄位（type/sector/industry/theme flags），適合做市場分類視角分析與索引維度整理。

此 endpoint 對應 `index_classification` live route，不是 AI 分群或動態評分模型。

• 查單一指數（index_code）分類屬性與旗標欄位。
• 建立市場分類清單，作為 dashboard 或研究分群維度。
• 搭配 index-data / market-breadth 進行市場結構與盤勢分析。

Request#

至少需要提供一個 filter（index_code、market、index_type、sector、industry 任一），未提供時會回傳 `missing_required_filter`。

Query Parameters#

Response Shape#

回應採 canonical envelope，頂層包含 query/meta，實際分類資料位於 envelope.data。

contract 僅包含 deterministic 分類欄位，不包含信心分數與動態 ranking。

{
  "api_version": "v2",
  "endpoint": "/v2/datasets/index-classification",
  "request_id": "req_idxcls_9f8e7d6c",
  "plan_id": "developer",
  "dataset": "index_classification",
  "query": {
    "index_code": "TWSE_TAIEX",
    "market": null,
    "index_type": null,
    "sector": null,
    "industry": null,
    "limit": 20,
    "offset": 0,
    "sort_by": "as_of_date",
    "sort_order": "desc"
  },
  "meta": {
    "rows_returned": 1
  },
  "envelope": {
    "dataset": "index_classification",
    "ticker": "TWSE_TAIEX",
    "as_of_date": "2026-04-22",
    "data": [
      {
        "index_code": "TWSE_TAIEX",
        "market": "TWSE",
        "as_of_date": "2026-04-22",
        "classification_version": "v1",
        "index_name": "發行量加權股價指數",
        "index_type": "broad_market",
        "sector": null,
        "industry": null,
        "parent_index_code": null,
        "is_sector_index": false,
        "is_broad_market_index": true,
        "theme_primary": null,
        "theme_secondary": null,
        "classification_source": "index_code_mapping_v1",
        "provider": "twse_official",
        "source_role": "canonical"
      }
    ]
  }
}

Field 說明#

Usage Notes / 使用建議#

• 此主題對外路由為 `/v2/datasets/index-classification`。
• 若需要指數點位與漲跌等行情欄位，請搭配 `/v2/datasets/index-data`。
• 查無資料通常回 200 空集合，建議依 `meta.rows_returned` 判斷結果。