個股關聯 ETF
GET/api/v1.0/quote/{symbol}/related-etf按正股標的代碼反查持有該股票作為成分股的 ETF 列表及該股在各 ETF 中的持倉佔比。 單股槓桿/反向 ETF 反查關聯正股請用 quote.etf_related_equity。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
symbol | string | 路徑 | 是 | 正股代碼（路徑參數），例: US.NVDA / US.AAPL / HK.00700 |
page_size | int | 查詢 | 否 | 每頁返回 ETF 數量，默認 20，最大 100 |
page_flag | string | 查詢 | 否 | 翻頁遊標，首頁不傳或傳空串；下一頁回傳 pagination.page_flag |
請求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/related-etf?page_size=1&page_flag=1' \
-H 'Authorization: Bearer <AccessToken>' | jq響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
data.items | object[] | |
data.items[].code | string | ETF 代碼，例: US.SPY |
data.items[].name | string | ETF 名稱 |
data.items[].weight_pct | number | 該正股在 ETF 中的持倉佔比（百分數，原始值放大 10000 倍） |
pagination.completed | string | 是否已到末頁 |
pagination.page_flag | string | 下一頁遊標 |
錯誤碼
| ret_code | error.code | 說明 |
|---|---|---|
| 0 | — | 成功 |
| -3 | invalid_parameter | 參數缺失或不在允許範圍內 |
| -7 | invalid_symbol | 標的不存在 |
| -8 | unsupported | 市場或品類不支持 |
| -9 | permission_denied | 沒有對應權限 |
| -10 | no_data | 沒有可返回的數據 |
| -11 | rate_limited | 調用過於頻繁 |
響應示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"items": [
{
"code": "example",
"name": "example",
"weight_pct": "example"
}
]
},
"pagination": {
"completed": true,
"page_flag": ""
}
}