按机构 ID 获取机构持仓概况

GET /api/v1.0/quote/institution/profile

按机构 ID 获取机构持仓概况：简介、持仓市值、建仓/清仓/增持/减持只数、十大持股占比、披露日期。 机构列表请用 quote.institution_list；行业分布请用 quote.institution_distribution。

请求参数

参数	类型	位置	必填	说明
market	string	查询	是	市场代码
institution_id	int	查询	是	机构 ID，来自 quote.institution_list 的 institution_id

请求示例

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/institution/profile?market=HK&institution_id=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

响应参数

参数	类型	说明
data.institution_id	int	机构 ID
data.institution_name	string	机构名称
data.description	string	机构简介
data.position_value	string	持仓市值（元）
data.last_position_value	string	上期持仓市值（元）
data.new_position_num	int	本期建仓只数
data.sold_out_position_num	int	本期清仓只数
data.increase_position_num	int	本期增持只数
data.decrease_position_num	int	本期减持只数
data.top10_percent_portfolio	number	十大持股占比（百分数）
data.top10_percent_portfolio_change	number	十大持股占比变动（百分数）
data.disclosure_date	string	披露日期，YYYY-MM-DD，时区随请求的 market
data.currency	string	市值币种
data.all_holding_count	int	总持股只数
data.holding_change_count	int	相对上期持仓变动只数
data.percent_position_value_change	string	市值变动比例（百分数）

错误码

ret_code	error.code	说明
0	—	成功
-3	invalid_parameter	参数不合法
-8	unsupported	不支持
-10	no_data	没有数据

响应示例

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "institution_id": 0,
    "institution_name": "example",
    "description": "example",
    "position_value": "example",
    "last_position_value": "example",
    "new_position_num": 0,
    "sold_out_position_num": 0,
    "increase_position_num": 0,
    "decrease_position_num": 0,
    "top10_percent_portfolio": 1.2,
    "top10_percent_portfolio_change": 1.2,
    "disclosure_date": "2026-10-16",
    "currency": "example",
    "all_holding_count": 0,
    "holding_change_count": 0,
    "percent_position_value_change": "example"
  }
}