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

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

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

Response Fields

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

Field	Type	Description
name	string	Shareholder name.
holder_pct	double	Holding percentage (%).
holder_id	int / null	Shareholder ID; null for the "Others" fallback row.
static_date	int	Data statistics timestamp (second-level).
static_date_str	string	Statistics date (yyyy-MM-dd).

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	Gateway internal error	Retry later, contact support if persistent

Response Example

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