Skip to content

Institutional Shareholders ​

GET /api/v1.0/quote/{symbol}/shareholders/institutional

Get the institutional holding summary (aggregated by reporting period) for a stock, returning institution count, total holdings and ratio with period-over-period changes, along with reporting period close/open/previous close prices.

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesSymbol code, e.g. HK.00700.
limitintquerynoNumber of reporting periods per page. Default 10, max 50.
next_keystringquerynoPagination cursor; leave empty for the first page.

Request Example ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/shareholders/institutional?limit=2" | jq

Response Fields ​

NameTypeDescription
dataobject
data.holdersobject[]
data.holders[].period_textstringReport period text (quarterly,.g. '2026/Q2'
data.holders[].institution_quantityintNumber of institutions, e.g. 861
data.holders[].institution_quantity_changeintQuarter-over-quarter change in number of institutions, e.g. -4
data.holders[].holder_quantityintTotal shares held by institutions (shares), e.g. 4210968623
data.holders[].holder_quantity_changeintQuarter-over-quarter change in institutional shares held (shares), e.g. 3889358
data.holders[].holder_pctnumberTotal institutional shareholding ratio (percentage), e.g. 46.682
data.holders[].holder_pct_changenumberQuarter-over-quarter change in institutional shareholding ratio (percentage), e.g. 0.06
data.holders[].close_pricenumberClose price for the report period (in reporting currency), e.g. 491.3
data.holders[].open_pricenumberOpen price for the report period (in reporting currency), e.g. 485.0
data.holders[].last_close_pricenumberPrevious close price for the report period (in reporting currency), e.g. 488.6
data.holders[].update_timeintData update time, millisecond timestamp, e.g. 1780203883000
data.holders[].update_time_strstringData update time string (in market timezone), format yyyy-MM-dd HH:mm:ss, e.g. '2026-05-31 13:04:43'
paginationobject
pagination.has_morebool
pagination.next_keystring

Supported Markets ​

  • Supported markets: HK / US / CA / AU / SG / JP.
  • Not supported: A-shares (SH/SZ/BJ), indices, futures, options, bonds, etc.

Error Codes ​

ret_codeerror.codeTrigger ConditionSuggested Action
0—Success—
-3invalid_parameterInvalid symbol format / limit out of rangeCorrect request parameters and retry
-7invalid_symbolCode cannot be resolved to a securityVerify code validity via search API
-10no_dataSymbol is valid but has no institutional holding dataNo institutional data available, no need to retry

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "holders": [
      {
        "period_text": "2026/Q2",
        "institution_quantity": 862,
        "institution_quantity_change": -2,
        "holder_quantity": 4478792804,
        "holder_quantity_change": 269027594,
        "holder_pct": 49.72,
        "holder_pct_change": 3.068,
        "close_price": 491.3,
        "open_price": 498.7,
        "last_close_price": 478.7,
        "update_time": 1780739688000,
        "update_time_str": "2026-06-06 17:54:48"
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "1767196799"
  }
}