股东概况
GET/api/v1.0/quote/{symbol}/shareholders/overview获取公司股东持股概况,返回前 5 大股东、按持有人类型统计的占比、可用持仓报告期列表。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 证券代码,如 HK.00700。 |
period_id | int | 查询 | 否 | 持仓报告期 ID。默认 0(最新一期)。 |
请求示例
bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/shareholders/overview" | jq响应字段
main_holder(前 5 大股东 + "其他"兜底行):
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.main_holder | object[] | 前 N 大股东(含“其他”类别)。每项 {static_date(秒级), static_date_str(yyyy-MM-dd), name, holder_pct(百分数), holder_id(int 或 null)}。例: [{static_date_str:'2026-05-24', name:'Prosus Ventures N.V.', holder_pct:23.05351, holder_id:337488017},..., {name:'其他', holder_pct:62.05948, holder_id:null}] |
data.holder_type | object[] | 按持有人类型统计的占比。每项 {static_date, static_date_str, name(类型名), holder_pct(百分数), holder_id(通常为 null)}。例: [{name:'风险资本/私募股权投资', holder_pct:23.14464}, {name:'传统投资经理', holder_pct:21.74729}, {name:'其他', holder_pct:45.44565}] |
data.holding_period | object[] | 可用持仓报告期列表(按 period_id 倒序)。每项 {period_id(int), period_text('YYYY/QN')}。例: [{period_id:90, period_text:'2026/Q2'}, {period_id:89, period_text:'2026/Q1'},..., {period_id:71, period_text:'2021/Q3'}] |
pagination | object | 部分接口返回分页信息 |
holder_type(按持有人类型统计):
| 字段 | 类型 | 说明 |
|---|---|---|
name | string | 持有人类型名称。 |
holder_pct | double | 占比(%)。 |
holding_period(可用持仓报告期列表):
| 字段 | 类型 | 说明 |
|---|---|---|
period_id | int | 报告期 ID。 |
period_text | string | 报告期文本(YYYY/QN)。 |
限制范围
- 市场:HK / US / SG / CA / AU / JP 正股有数据;A 股(SH/SZ/BJ)无股东概况数据。
- 品类:仅正股。ETF / 窝轮 / 期权 / 指数等三个数组均为空。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | — | 成功(含合法但无数据,数组为空) | — |
| -3 | invalid_parameter | period_id 非法 | 校正后重试 |
| -7 | invalid_symbol | 标的无法解析为证券 | 通过 search 接口确认代码合法性 |
| -2 / -4 / -6 | internal_error | 服务错误 | 稍后重试,持续失败联系支持 |
响应示例
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"
}
]
}
}