Skip to content

Top 10 ETF Holdings ​

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

Get top 10 constituent holdings and portfolio weights for an ETF. Returns: update_time, constituent code, holding_name, and holding_rate (percent).

Request ​

ParameterTypeInRequiredDescription
symbolstringpathyesETF symbol (path param), e.g. US.SPY / US.QQQ / HK.02800

Example ​

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

Response ​

FieldTypeDescription
data.itemsobject[]
data.update_timeintegerHoldings disclosure update timestamp in milliseconds
data.items[].codestringConstituent stock symbol (empty when unmapped)
data.items[].holding_namestringConstituent stock name
data.items[].holding_ratenumberPortfolio weight in percent

Errors ​

ret_codeerror.codeDescription
0—Success
-3invalid_parameterMissing or invalid parameter
-7invalid_symbolUnknown symbol
-8unsupportedMarket or product is not supported
-9permission_deniedMissing permission
-10no_dataNo data
-11rate_limitedToo many requests

Sample ​

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