Skip to content

Shareholders Overview ​

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

Get the shareholder holding overview for a company. Returns the top 5 shareholders, holder type distribution percentages, and available holding period list.

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesSecurity code, e.g. HK.00700.
period_idintquerynoHolding period ID. Default 0 (latest period).

Request Example ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/shareholders/overview" | jq

Response Fields ​

main_holder (Top 5 shareholders + "Others" fallback row):

NameTypeDescription
dataobject
data.main_holderobject[]Top N shareholders (with an 'Others' fallback row). Each item {static_date (seconds), static_date_str (yyyy-MM-dd), name, holder_pct (percentage), holder_id (int or null)}. e.g. [{static_date_str:'2026-05-24', name:'Prosus Ventures N.V.', holder_pct:23.05351, holder_id:337488017},..., {name:'Others', holder_pct:62.05948, holder_id:null}]
data.holder_typeobject[]Ownership ratios aggregated by holder type. name is server-provided and currently returned in Chinese. Each item {static_date, static_date_str, name (type name), holder_pct (percentage), holder_id (usually null)}. e.g. [{name:'传统投资经理', holder_pct:24.74297}, {name:'风险资本/私募股权投资', holder_pct:23.17564}, {name:'其他', holder_pct:42.39604}]
data.holding_periodobject[]List of available holding report periods (sorted by period_id descending). Each item {period_id (int), period_text ('YYYY/QN')}. e.g. [{period_id:90, period_text:'2026/Q2'}, {period_id:89, period_text:'2026/Q1'},..., {period_id:71, period_text:'2021/Q3'}]
paginationobjectPagination returned by some endpoints

holder_type (Distribution by holder type):

FieldTypeDescription
namestringHolder type name.
holder_pctdoubleProportion (%).

holding_period (Available holding period list):

FieldTypeDescription
period_idintPeriod ID.
period_textstringPeriod text (YYYY/QN).

Supported Markets ​

  • Markets: HK / US / SG / CA / AU / JP stocks have data; A-shares (SH/SZ/BJ) have no shareholders overview data.
  • Categories: Common stocks only. ETF / Warrants / Options / Indices etc. return empty arrays.

Error Codes ​

ret_codeerror.codeTrigger ConditionSuggested Action
0—Success (including valid but no data, arrays empty)—
-3invalid_parameterInvalid period_idCorrect and retry
-7invalid_symbolSymbol cannot be resolved to a securityVerify code validity via search API
-2 / -4 / -6internal_errorService errorRetry later, contact support if persistent

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "main_holder": [
      {
        "name": "Prosus Ventures N.V.",
        "holder_pct": 23.0871,
        "holder_id": 337488017,
        "static_date_str": "2026-06-06"
      },
      {
        "name": "Huateng Ma",
        "holder_pct": 7.88098,
        "holder_id": 10253703,
        "static_date_str": "2026-06-06"
      },
      {
        "name": "先锋领航",
        "holder_pct": 2.97518,
        "holder_id": 417222,
        "static_date_str": "2026-06-06"
      },
      {
        "name": "贝莱德",
        "holder_pct": 2.689,
        "holder_id": 403413,
        "static_date_str": "2026-06-06"
      },
      {
        "name": "Vanguard Capital Management, LLC",
        "holder_pct": 2.2974,
        "holder_id": 1951572549,
        "static_date_str": "2026-06-06"
      },
      {
        "name": "其他",
        "holder_pct": 61.07034,
        "holder_id": null,
        "static_date_str": "2026-06-06"
      }
    ],
    "holder_type": [
      {
        "name": "传统投资经理",
        "holder_pct": 24.74297,
        "holder_id": null
      },
      {
        "name": "风险资本/私募股权投资",
        "holder_pct": 23.17564,
        "holder_id": null
      },
      {
        "name": "个人",
        "holder_pct": 7.88568,
        "holder_id": null
      },
      {
        "name": "其他",
        "holder_pct": 42.39604,
        "holder_id": null
      }
    ],
    "holding_period": [
      {
        "period_id": 90,
        "period_text": "2026/Q2"
      },
      {
        "period_id": 89,
        "period_text": "2026/Q1"
      }
    ]
  }
}