EN 登入註冊

AI agent？先讀 /llms.txt 取得全站索引。

市場與價格

指數成分股

Name: Index constituents
Creator: TW Market Data
License: https://twmarketdata.com/zh-TW/legal/licensing

指數成分股——每個櫃買指數在某交易日的成分證券。僅含成分歸屬,不含權重。

← 指數成分股資料集總覽

衍生來源: TWSE·方案: free·計費: 2 點·GET /v2/datasets/index-constituents

指數成分股是台灣市場資料集,來源為 TWSE,由 TW Market Data 以 GET /v2/datasets/index-constituents 提供。

總覽

index-constituents 以櫃買官方成分股公布為源,每個指數、每個交易日、每檔成分證券回傳一列。此 feed 涵蓋六個櫃買指數,不含任何 TWSE 指數,且只記錄成分歸屬——裡面沒有成分權重。每次回應是快照而非異動記錄,證券退出指數只會不再出現,不會產生一列「移除」。不指定 trade_date 時,每個指數回傳最近一次快照。

欄位	型別	說明
`index_name`	string
`ticker`	string
`name`	string
`trade_date`	string
`market`	string

涵蓋範圍

列數	2,181
涵蓋起訖	2026-07-01 – 2026-08-21
分級	衍生
量測時間	2026-09-01取自資料集登錄表

範例回應

此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。

{
  "dataset_id": "index_constituents",
  "request_context": {
    "scope": "tw_index_membership_snapshots",
    "coverage_type": "per_date_snapshot",
    "filters": {
      "index_name": null,
      "ticker": null,
      "market": null,
      "trade_date": null,
      "latest_only": true,
      "limit": 50
    },
    "applied_defaults": {
      "latest_snapshot_per_index": true,
      "reason": "no trade_date given; returning each index's most recent membership snapshot rather than every historical snapshot combined"
    },
    "snapshot_dates_in_page": [
      "2026-08-04"
    ]
  },
  "quality": {
    "row_count": 50,
    "index_count": 1,
    "indices_present": [
      "櫃買公司治理"
    ],
    "ticker_count": 50,
    "sensitive_fields_exposed": false
  },
  "lineage": {
    "source_families": [
      "TPEX_INDEX_CONSTI"
    ],
    "semantics": "Which tickers belonged to which index on a given trade_date. Membership only — no weights. Without a trade_date the response is each index's most recent snapshot."
  },
  "error": null,
  "data": [
    {
      "index_name": "櫃買公司治理",
      "ticker": "1268",
      "name": "漢來美食",
      "trade_date": "2026-08-04",
      "market": "TPEx",
      "provider": "twse_official",
      "source_role": "official_tpex_index_constituents",
      "source_authority": "TPEx openapi 指數成分股",
      "source_family": "TPEX_INDEX_CONSTI"
    },
    {
      "index_name": "櫃買公司治理",
      "ticker": "2755",
      "name": "揚秦",
      "trade_date": "2026-08-04",
      "market": "TPEx",
      "provider": "twse_official",
      "source_role": "official_tpex_index_constituents",
      "source_authority": "TPEx openapi 指數成分股",
      "source_family": "TPEX_INDEX_CONSTI"
    }
  ],
  "data_count": 50,
  "known_gaps": [
    "per_date_membership_snapshot_not_a_change_log_a_removal_produces_no_row",
    "TPEx_indices_ONLY_six_of_them_no_TWSE_index_is_in_this_feed",
    "single_snapshot_2026_07_01_there_is_no_history_and_no_producer_advancing_it"
  ],
  "warnings": [
    "not_investment_advice"
  ],
  "envelope": {
    "dataset_id": "index_constituents",
    "scope": "tw_index_membership_snapshots",
    "row_count": 50
  }
}

擷取自 2026-07-20 的線上 API。

本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。

出處

以下欄位會隨資料一併回傳,記錄這一列的來源。它們屬於出處而非本資料集要講的事實,因此列在這裡而不進欄位表。

providersource_rolesource_authoritysource_family

授權與顯名

本服務部分資料取自政府資料開放平臺(data.gov.tw),依「政府資料開放授權條款-第1版」授權利用。資料提供機關:臺灣證券交易所、證券櫃檯買賣中心、臺灣期貨交易所、臺灣集中保管結算所、國家發展委員會、中央銀行、經濟部統計處、財政部關務署。本服務之加值處理、衍生計算與呈現方式由 TWMD 負責,與各資料提供機關無涉。

引用此資料集

TW Market Data. (n.d.). 指數成分股 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/market-prices/index-constituents

版本取自資料集自己的 as_of，不是這一頁的產生日期。沒有 as_of 的資料集就不列這個欄位，不會補一個看起來合理的值。驗證簽章

可與本資料集對齊的其他資料集。每組都標出可用來 join 的欄位,規劃跨表查詢時不必自己猜。

漲跌停事件
可用 market + ticker + trade_date 對齊
價格調整因子
可用 market + ticker + trade_date 對齊
大波動日情境卡
可用 market + ticker + trade_date 對齊
漲跌停價日線
可用 market + ticker + trade_date 對齊
技術指標
可用 market + ticker + trade_date 對齊
TWSE 日線價格
可用 ticker + trade_date 對齊
核心估值日線
可用 ticker + trade_date 對齊

快速開始

把你的金鑰放進 X-API-Key 標頭。
加上查詢參數（symbol、日期區間、limit）。
送出請求並讀取 data 陣列。

curl "https://api.twmarketdata.com/v2/datasets/index-constituents?ticker=1268&market=TPEx&limit=5" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`index_name`	否	string	櫃買公布的指數名稱（中文），例如櫃買公司治理。不帶篩選呼叫一次即可從回傳列讀出六個指數名。
`ticker`	否	string	成分股代碼；回傳該檔所屬的每個指數。
`market`	否	string	市場別。此 feed 只有 TPEx。
`trade_date`	否	string	快照日期（YYYY-MM-DD）。不帶則每個指數回傳最近一次快照。
`latest_only`	否	boolean	預設 true；設為 false 可取得較早的快照。
`limit`	否	integer	回傳筆數上限。

Python 範例

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/index-constituents",
    params={"ticker": "1268", "market": "TPEx", "limit": "5"},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["data"])

OpenAPI

此端點為 GET /v2/datasets/index-constituents。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。

備註與限制

此端點以 index_name、ticker、market、trade_date、latest_only 篩選;symbol 與 index_code 都不是篩選條件,會被忽略而非報錯。
僅六個櫃買(TPEx)指數,此 feed 不含任何 TWSE 指數;且僅有成分歸屬,列上沒有成分權重。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/index-constituents?limit=5" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "dataset_id": "index_constituents",
  "quality": {
    "row_count": "<number>",
    "index_count": "<number>",
    "indices_present": "<array>",
    "ticker_count": "<number>",
    "sensitive_fields_exposed": "<boolean>"
  },
  "error": null,
  "data": [
    {
      "index_name": "<string>",
      "ticker": "<string>",
      "name": "<string>",
      "trade_date": "<string>",
      "market": "<string>",
      "provider": "<string>",
      "source_role": "<string>",
      "source_authority": "<string>",
      "source_family": "<string>"
    }
  ],
  "data_count": 50,
  "known_gaps": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ],
  "envelope": {
    "dataset_id": "<string>",
    "scope": "<string>",
    "row_count": "<number>"
  }
}