Ownership ETF Holdings

取得指定 ETF 在日期區間內的每日成分股清單，含成分股代號、名稱、持股數、權重，以及相對前一個有資料日的變動。

GET /ownership/etf-holdings/{symbol}

info

屬於 開發者 及 進階用戶 方案的專屬功能！

Parameters

Name	Type	Description
`symbol`*	string	ETF 代碼（如 `0050`、`00981A`）
`from`	string	開始日期（格式：`yyyy-MM-dd`），預設 30 天前；與 `to` 的間隔須小於 1 年
`to`	string	結束日期（格式：`yyyy-MM-dd`），預設今天
`sort`	string	依日期排序，預設 `desc` 降冪；可選 `asc` 升冪

Response

Name	Type	Description
`type`*	string	證券類型
`exchange`*	string	交易所
`market`*	string	市場別
`symbol`*	string	ETF 代號
`data`*	object[]	每日成分資料，一日一筆
`data.date`*	string	日期
`data.components`*	object[]	成分股清單
`data.components.symbol`*	string	成分股代號（海外型 ETF 可能為外國代號，如 `AAPL UQ`）
`data.components.name`	string	成分股名稱
`data.components.quantity`	number	持股股數
`data.components.weight`	number	權重（%）
`data.components.quantityChange`	number	相對上一個有資料日的持股變動（首日省略）
`data.components.weightChange`	number	相對上一個有資料日的權重變動（首日省略）

資料說明

資料來源：整理自各 ETF 發行投信公司公開揭露之每日成分資訊，僅供參考，實際持股內容以各投信公司／基金公開說明書之公告為準。
查詢區間：單次查詢 from 與 to 的間隔須小於 1 年，超過會回傳 400（例如 from=2025-07-29&to=2026-07-29 恰好 1 年會被拒絕）；日期格式錯誤或 from 晚於 to 亦回傳 400。
歷史涵蓋：成分資料可追溯至 2019 年，個別 ETF 依上市日與發行商揭露情況而定；個別交易日可能因發行商揭露而無資料，以實際回傳為準。
權重範圍：本資料僅涵蓋 ETF 的股票部位成分，權重加總不一定為 100%（差額為現金、期貨、債券或未揭露部位）。台股股票型（被動或主動）通常接近 100%；海外股票型多在 90% 上下；平衡型／多重資產型與槓桿型僅回股票部位，加總可能僅數十個百分點；無股票部位者（純債券型、期貨型、商品型、反向型，以及部分匯率避險／外幣計價級別）回傳 data: []。
變動欄位：quantityChange / weightChange 為相對「該 ETF 上一個有成分資料的日期」之差，不保證對照前一交易日；該 ETF 首個有資料日不含此兩欄位。
查無資料：非 ETF 代號、不存在的代號或該區間無揭露時，皆回傳 200 與 data: []（不回 404）；此時 type／exchange／market 為預設值，不代表該代號的真實屬性。
呼叫額度：台股盤後籌碼系列 API 共用同一呼叫額度（以方案的「台股盤後籌碼」額度計）。

Example

cURL
Python
Node.js

curl -X 'GET' \
  'https://api.fugle.tw/marketdata/v1.0/stock/ownership/etf-holdings/0050?from=2026-05-21&to=2026-05-21' \
  -H 'X-API-KEY: <YOUR_API_KEY>'

from fugle_marketdata import RestClient

client = RestClient(api_key = 'YOUR_API_KEY')  # 輸入您的 API key
stock = client.stock  # Stock REST API client

stock.ownership.etf_holdings(**{"symbol": "0050", "from": "2026-05-21", "to": "2026-05-21"})

const { RestClient } = require('@fugle/marketdata');

const client = new RestClient({ apiKey: 'YOUR_API_KEY' });
client.stock.ownership.etfHoldings({ symbol: '0050', from: '2026-05-21', to: '2026-05-21' })
  .then(data => console.log(data));

Response Body：

{
  "type": "EQUITY",
  "exchange": "TWSE",
  "market": "TSE",
  "symbol": "0050",
  "data": [
    {
      "date": "2026-05-21",
      "components": [
        // 為節省篇幅僅列前 2 檔，實際回傳為當日全部成分股
        {
          "symbol": "2330",
          "name": "台積電",
          "quantity": 481180146,
          "weight": 60.61,
          "quantityChange": 1538880,
          "weightChange": -0.18
        },
        {
          "symbol": "2454",
          "name": "聯發科",
          "quantity": 28975109,
          "weight": 5.4,
          "quantityChange": 92760,
          "weightChange": 0.16
        }
      ]
    }
  ]
}

Parameters​

Response​

Example​

Parameters

Response

Example