股东概况

GET /v1/quote/{symbol}/f10/shareholders-overview

获取公司股东持股概况，返回前 5 大股东、按持有人类型统计的占比、可用持仓报告期列表。

请求参数

参数	类型	位置	必填	说明
symbol	string	路径	是	证券代码，如 HK.00700。
period_id	int	查询	否	持仓报告期 ID。默认 0（最新一期）。

请求示例

curl "$ip/v1/quote/HK.00700/f10/shareholders-overview" | jq

响应字段

main_holder（前 5 大股东 + "其他"兜底行）：

字段	类型	说明
name	string	股东名称。
holder_pct	double	持股占比（%）。
holder_id	int / null	股东 ID；"其他"兜底行为 null。
static_date	int	数据统计时间戳（秒级）。
static_date_str	string	统计日期（yyyy-MM-dd）。

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	网关内部错误	稍后重试，持续失败联系支持

响应示例

{
  "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" }
    ]
  }
}