AI agent？先讀 /llms.txt 取得全站索引。
基金與企業情報
ETF 持股明細——每檔 ETF 最新揭露的成分股清單(成分、權重、資料日期),來源為發行機構。
GET /v2/datasets/etf-holdingsetf-holdings 為參考型資料集:每檔 ETF 回傳其最新揭露投資組合的成分股與各自權重,來源為發行機構。此為發行機構受限的最新快照——僅涵蓋發行機構有揭露持股的 ETF,且僅最新一期揭露,非全市場或歷史持股序列。每列附來源角色與 lineage,權重可與發行機構揭露對帳。
| 欄位 | 型別 | 說明 |
|---|---|---|
symbol | string | ETF 代碼(如 0050)。 |
constituent_symbol | string | 所持成分股之代碼。 |
constituent_name | string | 所持成分股之名稱。 |
weight_pct | number | 該成分股於 ETF 之權重(百分比)。 |
as_of | string | 此持股快照之揭露日期。 |
source_role | string | 正規來源角色(issuer_etf_holdings)。 |
| 列數 | 9,425 |
| 涵蓋起訖 | 2026-06-04 至 2026-07-16 |
| 分級 | 參考 |
此為本端點的真實回應。資料列位於 "data" 之下，來源資訊如下方所示；各資料集形狀不盡相同，請以本頁為準。
{ "dataset_id": "etf_holdings", "request_context": { "scope": "fubon_issuer_limited_latest_available_snapshot_set", "coverage_type": "latest_available_snapshot_set", "filters": { "etf_code": null, "issuer": null, "as_of_date": null, "holding_ticker": null, "market": null, "source_family": null, "limit": 50 }, "min_as_of_date": "2026-07-16", "max_as_of_date": "2026-07-16" }, "quality": { "row_count": 50, "etf_count": 1, "sensitive_fields_exposed": false }, "lineage": { "source_providers": [ "etfapi.yuantaetfs.com" ], "source_roles": [ "etf_holdings" ], "source_families": [ "pcf_yuanta" ] }, "error": null, "data": [ { "etf_code": "0050", "etf_name": "元大台灣卓越50基金", "issuer": "yuanta", "market": "TWSE", "as_of_date": "2026-07-16", "holding_ticker": "1216", "holding_name": "統一", "holding_weight": 0.38, "holding_units": 108225075, "holding_market": null, "source_provider": "etfapi.yuantaetfs.com", "source_role": "etf_holdings", "source_family": "pcf_yuanta", "lineage": { "url": "https://etfapi.yuantaetfs.com/ectranslation/api/bridge?APIType=ETFAPI&CompanyName=YUANTAFUNDS&PageName=%2FtradeInfo%2Fpcf%2F0050&DeviceId=null&FuncId=PCF%2FDaily&AppName=ETF&Device=3&Platform=ETF&ticker=0050&ndate=20260716", "parser": "feature_engine.etf.pcf_sources:yuanta", "source": "official_issuer_pcf", "pcf_meta": { "nav": 106.36, "fundid": "1066", "osunit": 21113000000, "anndate": "20260717", "totalav": 2245633183230, "upddate": "2026-07-16 16:24:05", "trandate": "20260716", "inkind_rows": 50 }, "fetched_at": "2026-07-18T17:47:07.565821+00:00", "parser_version": "v1" }, "data_gaps": [] }, { "etf_code": "0050", "etf_name": "元大台灣卓越50基金", "issuer": "yuanta", "market": "TWSE", "as_of_date": "2026-07-16", "holding_ticker": "1303", "holding_name": "南亞", "holding_weight": 1.07, "holding_units": 108086690, "holding_market": null, "source_provider": "etfapi.yuantaetfs.com", "source_role": "etf_holdings", "source_family": "pcf_yuanta", "lineage": { "url": "https://etfapi.yuantaetfs.com/ectranslation/api/bridge?APIType=ETFAPI&CompanyName=YUANTAFUNDS&PageName=%2FtradeInfo%2Fpcf%2F0050&DeviceId=null&FuncId=PCF%2FDaily&AppName=ETF&Device=3&Platform=ETF&ticker=0050&ndate=20260716", "parser": "feature_engine.etf.pcf_sources:yuanta", "source": "official_issuer_pcf", "pcf_meta": { "nav": 106.36, "fundid": "1066", "osunit": 21113000000, "anndate": "20260717", "totalav": 2245633183230, "upddate": "2026-07-16 16:24:05", "trandate": "20260716", "inkind_rows": 50 }, "fetched_at": "2026-07-18T17:47:07.565821+00:00", "parser_version": "v1" }, "data_gaps": [] } ], "data_count": 50, "known_gaps": [ "latest_available_snapshot_only", "issuer_limited_fubon_only", "approved_etf_scope_only=fubon_page_discovered_50_etfs" ], "warnings": [ "not_investment_advice" ], "envelope": { "dataset_id": "etf_holdings", "scope": "fubon_issuer_limited_latest_available_snapshot_set", "row_count": 50 }}擷取自 2026-07-20 的線上 API。
本頁顯示原始中文值；英文頁會以標記取代，以維持全英文。
curl "https://api.twmarketdata.com/v2/datasets/etf-holdings?symbol=2330" \ -H "X-API-Key: sk_live_..."| 參數 | 必填 | 型別 | 說明 |
|---|---|---|---|
symbol | 否 | string | 以股票代碼篩選單一標的。 |
limit | 否 | integer | 回傳筆數上限。 |
第一個呼叫：
import requests resp = requests.get( "https://api.twmarketdata.com/v2/datasets/etf-holdings", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()print(resp.json()["data"])帶日期區間篩選：
import requests # The full verified example — the same call with every supported filter set.resp = requests.get( "https://api.twmarketdata.com/v2/datasets/etf-holdings", params={"symbol": "2330"}, headers={"X-API-Key": "sk_live_..."},)resp.raise_for_status()for row in resp.json()["data"]: print(row)此端點為 GET /v2/datasets/etf-holdings。完整機器可讀 schema（參數、認證、回應封裝）見 OpenAPI spec。