ETF 前十大重倉股

GET /api/v1.0/quote/{symbol}/etf/top-holdings

獲取 ETF 的前十大重倉成分股列表及其持倉權重佔比。 返回包含：更新時間（update_time）、各重倉成分股代碼（code）、成分股名稱（holding_name）及佔 ETF 淨值比例（holding_rate，百分數）。 ETF 行業/地區投資分佈請用 quote.etf_investment_distribution；ETF 歷史資產規模請用 quote.etf_net_assets。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	ETF 代碼（路徑參數），例: US.SPY / US.QQQ / HK.02800

請求示例

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/etf/top-holdings' \
  -H 'Authorization: Bearer <AccessToken>' | jq

響應參數

參數	類型	說明
data.items	object[]
data.update_time	integer	持倉披露更新時間戳（毫秒）
data.items[].code	string	成分股標的代碼（未匹配證券 ID 時為空串）
data.items[].holding_name	string	成分股名稱
data.items[].holding_rate	number	持倉佔 ETF 淨值比例（百分數，原始值放大 1000 倍，55.23 表示 55.23%）

錯誤碼

ret_code	error.code	說明
0	—	成功
-3	invalid_parameter	參數缺失或不在允許範圍內
-7	invalid_symbol	標的不存在
-8	unsupported	市場或品類不支持
-9	permission_denied	沒有對應權限
-10	no_data	沒有可返回的數據
-11	rate_limited	調用過於頻繁

響應示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "update_time": "example",
    "items": [
      {
        "code": "example",
        "holding_name": "example",
        "holding_rate": "example"
      }
    ]
  }
}