Popular Institutions

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

Get popular institutional investors along with their top holdings and recent position changes preview. Returns: institution_id, institution_name, picture_url, top_holdings, and recent_changes. For the full institution list use quote.institution_list; for institution profile use quote.institution_profile.

Request

Parameter	Type	In	Required	Description
market	string	query	no	Market filter, default US
count	int	query	no	Number of popular institutions to return, default 6, max 20

Example

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

Response

Field	Type	Description
data.items	object[]
data.items[].institution_id	integer	Institution ID
data.items[].institution_name	string	Institution name
data.items[].picture_url	string	Institution avatar URL
data.items[].top_holdings	object	Top holdings preview (up to 2 stocks)
data.items[].top_holdings[].code	string	Stock symbol
data.items[].top_holdings[].holding_value	string	Holding market value
data.items[].top_holdings[].portfolio_pct	number	Weight in portfolio (percent)
data.items[].recent_changes	object	Recent position changes preview (up to 2 stocks)
data.items[].recent_changes[].code	string	Stock symbol
data.items[].recent_changes[].holding_value	string	Holding market value
data.items[].recent_changes[].portfolio_pct	number	Weight in portfolio (percent)
data.items[].recent_changes[].share_change	string	Change in shares

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-7	invalid_symbol	Unknown symbol
-8	unsupported	Market or product is not supported
-9	permission_denied	Missing permission
-10	no_data	No data
-11	rate_limited	Too many requests

Sample

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "institution_id": 0,
        "institution_name": "example",
        "picture_url": "example",
        "top_holdings": "example",
        "recent_changes": "example"
      }
    ]
  }
}