Shareholders Overview
GET/api/v1.0/quote/{symbol}/shareholders/overviewGet the shareholder holding overview for a company. Returns the top 5 shareholders, holder type distribution percentages, and available holding period list.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
symbol | string | path | yes | Security code, e.g. HK.00700. |
period_id | int | query | no | Holding period ID. Default 0 (latest period). |
Request Example
bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/shareholders/overview" | jqResponse Fields
main_holder (Top 5 shareholders + "Others" fallback row):
| Name | Type | Description |
|---|---|---|
data | object | |
data.main_holder | object[] | 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_type | object[] | 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_period | object[] | 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'}] |
pagination | object | Pagination returned by some endpoints |
holder_type (Distribution by holder type):
| Field | Type | Description |
|---|---|---|
name | string | Holder type name. |
holder_pct | double | Proportion (%). |
holding_period (Available holding period list):
| Field | Type | Description |
|---|---|---|
period_id | int | Period ID. |
period_text | string | Period 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_code | error.code | Trigger Condition | Suggested Action |
|---|---|---|---|
| 0 | — | Success (including valid but no data, arrays empty) | — |
| -3 | invalid_parameter | Invalid period_id | Correct and retry |
| -7 | invalid_symbol | Symbol cannot be resolved to a security | Verify code validity via search API |
| -2 / -4 / -6 | internal_error | Service error | Retry 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"
}
]
}
}