Skip to content

Holder Detail ​

GET /api/v1.0/quote/{symbol}/shareholders/holder-detail

Get the shareholder holding detail list for a stock, with filtering by holder type / reporting period / holder ID, and sorting by shares held or change amount.

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesSymbol code, e.g. HK.00700.
request_typeintquerynoHolder type filter. Default 1000 (all). See Naming Dictionary.
period_idintquerynoReporting period ID filter. Default 0 (latest).
holder_idintquerynoFilter by holder ID. Default 0 (no filter).
sort_columnintquerynoSort column. Default 61. 61=shares held, 62=shares change.
sort_typeintquerynoSort direction. 0=descending (default), 1=ascending.
limitintquerynoPage size. 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/holder-detail?limit=2" | jq

Response Fields ​

NameTypeDescription
dataobject
data.holdersobject[]
data.holders[].period_textstringReport period text. e.g. '2026/Q2'
data.holders[].holder_idintShareholder ID, e.g. 337488017
data.holders[].namestringShareholder name, e.g. 'Prosus Ventures N.V.'
data.holders[].holder_quantityintShareholding quantity (shares), e.g. 2079512000
data.holders[].holder_quantity_changeintQuarter-over-quarter change in shareholding quantity (shares), e.g. 0
data.holders[].holder_pctnumberShareholding ratio (percentage), e.g. 23.053
data.holders[].holder_pct_changenumberQuarter-over-quarter change in shareholding ratio (percentage), e.g. 0
data.holders[].holding_dateintHolding date, millisecond timestamp, e.g. 1767110400000
data.holders[].holding_date_strstringHolding date string (calendar date in HK timezone), format yyyy-MM-dd, e.g. '2025-12-31'
data.holders[].close_pricenumberCurrent period close price (in reporting currency), e.g. 491.3
data.holders[].price_change_pctnumberPrice change percentage, e.g. 2.6321
data.holders[].source_group_namestringData source (English), e.g. 'Annual Report' / '13F' / 'Form 4'
data.holders[].holder_date_stampintHolding-period stamp (used to distinguish/plot periods), millisecond timestamp, e.g. 1767110400000
data.holders[].is_min_periodboolWhether this is the minimum (earliest) available period, e.g. false
data.holders[].update_timeintData update time, millisecond timestamp, e.g. 1779555197000
data.holders[].update_time_strstringData update time string (in market timezone), format yyyy-MM-dd HH:mm:ss, e.g. '2026-05-24 00:53:17'
paginationobject
pagination.has_morebool
pagination.next_keystring

Supported Markets ​

  • Supported markets: HK / US / SG / JP / CA / AU equities.
  • Not supported: SH / SZ (A-shares) and ETF / indices / warrants / options / futures etc.

Error Codes ​

ret_codeerror.codeTrigger ConditionSuggested Action
0—Success—
-3invalid_parameterParameter type error / out of range / invalid enumFix and retry
-7invalid_symbolSymbol cannot resolve to a securityUse the search API to verify the symbol
-10no_dataValid request but no holder detail dataConfirm symbol/filter is within supported scope
-2 / -4 / -6internal_errorService errorRetry later; contact support if persistent

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "holders": [
      {
        "period_text": "2026/Q2",
        "holder_id": 337488017,
        "name": "Prosus Ventures N.V.",
        "holder_quantity": 2079512000,
        "holder_quantity_change": 0,
        "holder_pct": 23.087,
        "holder_pct_change": 0,
        "holding_date": 1767110400000,
        "holding_date_str": "2025-12-31",
        "close_price": 491.3,
        "price_change_pct": 2.6321,
        "source_group_name": "Annual Report",
        "update_time": 1780677957000,
        "update_time_str": "2026-06-06 00:45:57"
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "2"
  }
}