股東概況

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