EN 登入註冊

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

基金與企業情報

ETF 持股明細

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

ETF 持股明細——每檔 ETF 最新揭露的成分股清單(成分、權重、資料日期),來源為發行機構。

← ETF 持股明細資料集總覽

參考來源: Issuer·授權: 第一手揭露（非開放資料授權）·方案: developer·計費: 2 點·GET /v2/datasets/etf-holdings

ETF 持股明細是台灣市場資料集,來源為 Issuer,由 TW Market Data 以 GET /v2/datasets/etf-holdings 提供。

總覽

etf-holdings 為參考型資料集:每檔 ETF 回傳其最新揭露投資組合的成分股與各自權重,來源為發行機構。此為發行機構受限的最新快照——僅涵蓋發行機構有揭露持股的 ETF,且僅最新一期揭露,非全市場或歷史持股序列。每列附來源角色與 lineage,權重可與發行機構揭露對帳。

欄位	型別	說明
`etf_code`	string
`etf_name`	string
`issuer`	string
`market`	string
`as_of_date`	string
`holding_ticker`	string
`holding_name`	string
`holding_weight`	number
`holding_units`	number
`holding_market`	null

涵蓋範圍

列數	10,625
涵蓋起訖	2026-06-04 – 2026-09-04
分級	參考
量測時間	2026-09-04取自資料集登錄表

範例回應

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

{
  "dataset_id": "etf_holdings",
  "request_context": {
    "scope": "fubon_issuer_limited_latest_available_snapshot_set",
    "coverage_type": "latest_available_snapshot_set",
    "filters": {
      "etf_code": "00645",
      "issuer": null,
      "as_of_date": null,
      "holding_ticker": null,
      "market": null,
      "source_family": null,
      "limit": 50
    },
    "min_as_of_date": "2026-06-05",
    "max_as_of_date": "2026-06-05"
  },
  "quality": {
    "row_count": 50,
    "etf_count": 1,
    "sensitive_fields_exposed": false
  },
  "lineage": {
    "source_providers": [
      "富邦投信"
    ],
    "source_roles": [
      "issuer_official"
    ],
    "source_families": [
      "fubon_etf_assets_page"
    ]
  },
  "error": null,
  "data": [
    {
      "etf_code": "00645",
      "etf_name": "富邦日本",
      "issuer": "富邦投信",
      "market": "TWSE",
      "as_of_date": "2026-06-05",
      "holding_ticker": "1301 JP",
      "holding_name": "KYOKUYO CO LTD",
      "holding_weight": 0.0033,
      "holding_units": 100,
      "holding_market": null,
      "source_provider": "富邦投信",
      "source_role": "issuer_official",
      "source_family": "fubon_etf_assets_page",
      "lineage": {},
      "data_gaps": [
        "holding_market_not_provided_by_source"
      ]
    },
    {
      "etf_code": "00645",
      "etf_name": "富邦日本",
      "issuer": "富邦投信",
      "market": "TWSE",
      "as_of_date": "2026-06-05",
      "holding_ticker": "1332 JP",
      "holding_name": "NIPPON SUISAN KAISHA LTD",
      "holding_weight": 0.0361,
      "holding_units": 3700,
      "holding_market": null,
      "source_provider": "富邦投信",
      "source_role": "issuer_official",
      "source_family": "fubon_etf_assets_page",
      "lineage": {},
      "data_gaps": [
        "holding_market_not_provided_by_source"
      ]
    }
  ],
  "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。

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

出處

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

source_providersource_rolesource_familylineagedata_gaps

授權與顯名

資料來源：各投信發行商（PCF 第一手揭露） — 本資料集為發行商第一手揭露，非政府開放資料，不適用政府資料開放授權條款；其散布條款尚待逐家確認。

引用此資料集

TW Market Data. (n.d.). ETF 持股明細 [Data set]. TW Market Data. Retrieved 2026-09-05, from https://twmarketdata.com/zh-TW/docs/api/funds-intel/etf-holdings

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

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

期貨市場日資料
可用 as_of_date + market 對齊
GHG 碳揭露（範疇1/2/3）
可用 as_of_date + market 對齊
財務比率指標
可用 as_of_date + market 對齊
指數分類
可用 as_of_date + market 對齊
三大法人買賣
可用 as_of_date + market 對齊
稅籍／商業登記
同分類:funds-intel

快速開始

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

curl "https://api.twmarketdata.com/v2/datasets/etf-holdings?etf_code=00645" \
  -H "X-API-Key: sk_live_..."

篩選參數

參數	必填	型別	說明
`symbol`	否	string	以股票代碼篩選單一標的。
`limit`	否	integer	回傳筆數上限。

Python 範例

import requests

resp = requests.get(
    "https://api.twmarketdata.com/v2/datasets/etf-holdings",
    params={"etf_code": "00645"},
    headers={"X-API-Key": "sk_live_..."},
)
resp.raise_for_status()
print(resp.json()["data"])

OpenAPI

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

備註與限制

發行機構受限的最新快照:涵蓋範圍為發行機構有揭露持股的 ETF,且僅其最新揭露日期——請勿當作全市場或 point-in-time 歷史持股序列使用。
此資料集的 symbol 參數為 ETF 代碼(如 0050),非一般股票代碼。

請求與回應

請求

curl "https://api.twmarketdata.com/v2/datasets/etf-holdings?symbol=2330&limit=5" \
  -H "X-API-Key: $TWMD_API_KEY"

回應

{
  "dataset_id": "etf_holdings",
  "quality": {
    "row_count": "<number>",
    "etf_count": "<number>",
    "sensitive_fields_exposed": "<boolean>"
  },
  "error": null,
  "data": [
    {
      "etf_code": "<string>",
      "etf_name": "<string>",
      "issuer": "<string>",
      "market": "<string>",
      "as_of_date": "<string>",
      "holding_ticker": "<string>",
      "holding_name": "<string>",
      "holding_weight": "<number>",
      "holding_units": "<number>",
      "holding_market": "<null>",
      "source_provider": "<string>",
      "source_role": "<string>",
      "source_family": "<string>",
      "lineage": {},
      "data_gaps": "<array>"
    }
  ],
  "data_count": 50,
  "known_gaps": [
    "<string>"
  ],
  "warnings": [
    "<string>"
  ],
  "envelope": {
    "dataset_id": "<string>",
    "scope": "<string>",
    "row_count": "<number>"
  }
}