熱門機構預覽
GET/api/v1.0/quote/institution/popular獲取熱門明星機構列表及其代表性重倉股與近期增減持標的預覽。 返回包含：機構 ID（institution_id）、機構名稱、頭像圖片鏈接、代表性持倉股列表（top_holdings）與近期增減持標的列表（recent_changes）。 機構完整列表請用 quote.institution_list；單機構詳情請用 quote.institution_profile。
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
market | string | 查詢 | 否 | 市場過濾，默認 US |
count | int | 查詢 | 否 | 返回熱門機構數量，默認 6，最大 20 |
請求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/institution/popular?market=1&count=1' \
-H 'Authorization: Bearer <AccessToken>' | jq響應參數
| 參數 | 類型 | 說明 |
|---|---|---|
data.items | object[] | |
data.items[].institution_id | integer | 機構 ID |
data.items[].institution_name | string | 機構名稱，例: Berkshire Hathaway Inc. |
data.items[].picture_url | string | 機構頭像鏈接 |
data.items[].top_holdings | object | 代表性重倉股預覽（最多 2 只） |
data.items[].top_holdings[].code | string | 標的代碼 |
data.items[].top_holdings[].holding_value | string | 持倉市值（元） |
data.items[].top_holdings[].portfolio_pct | number | 佔機構投資組合比例（百分數） |
data.items[].recent_changes | object | 近期代表性增減持標的預覽（最多 2 只） |
data.items[].recent_changes[].code | string | 標的代碼 |
data.items[].recent_changes[].holding_value | string | 持倉市值（元） |
data.items[].recent_changes[].portfolio_pct | number | 佔機構投資組合比例（百分數） |
data.items[].recent_changes[].share_change | 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": [
{
"institution_id": 0,
"institution_name": "example",
"picture_url": "example",
"top_holdings": "example",
"recent_changes": "example"
}
]
}
}