按機構 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"
  }
}