Skip to content

股东明细 ​

GET /api/v1.0/quote/{symbol}/shareholders/holder-detail

获取指定股票的股东持股明细列表,支持按持有人类型 / 报告期 / 股东 ID 过滤,并按持股数量或变动数排序。

请求参数 ​

参数类型位置必填说明
symbolstring路径是证券代码,如 HK.00700。
request_typeint查询否持有人类型过滤。默认 1000(全部)。详见命名词典。
period_idint查询否报告期 ID 过滤。默认 0(最新)。
holder_idint查询否按股东 ID 过滤。默认 0(不过滤)。
sort_columnint查询否排序列。默认 61。61=持股数量,62=持股变动数。
sort_typeint查询否排序方向。0=降序(默认),1=升序。
limitint查询否每页条数。默认 10,最大 50。
next_keystring查询否翻页游标,首页留空。

请求示例 ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/shareholders/holder-detail?limit=2" | jq

响应字段 ​

参数类型说明
dataobject
data.holdersobject[]
data.holders[].period_textstring报告期文本(按 period_id 反算 year=2004+(pid-1)/4, quarter=(pid-1)%4+1)。例: '2026/Q2'
data.holders[].holder_idint股东 ID,例: 337488017
data.holders[].namestring股东名称,例: 'Prosus Ventures N.V.'
data.holders[].holder_quantityint持股数量(股),例: 2079512000
data.holders[].holder_quantity_changeint持股数量环比变动(股),例: 0
data.holders[].holder_pctnumber持股比例(百分数),例: 23.053
data.holders[].holder_pct_changenumber持股比例环比变动(百分数),例: 0
data.holders[].holding_dateint持股日期,毫秒时间戳,例: 1767110400000
data.holders[].holding_date_strstring持股日期字符串(HK 时区落日历),格式 yyyy-MM-dd,例: '2025-12-31'
data.holders[].close_pricenumber当期收盘价(按报告币种),例: 491.3
data.holders[].price_change_pctnumber价格变动百分比,例: 2.6321
data.holders[].source_group_namestring数据来源(英文),例: 'Annual Report' / '13F' / 'Form 4'
data.holders[].holder_date_stampint持股所属周期戳(用于区分/绘制周期),毫秒时间戳,例: 1767110400000
data.holders[].is_min_periodbool是否为最小(最早)可用周期,例: false
data.holders[].update_timeint数据更新时间,毫秒时间戳,例: 1779555197000
data.holders[].update_time_strstring数据更新时间字符串(按市场时区),格式 yyyy-MM-dd HH:mm:ss,例: '2026-05-24 00:53:17'
paginationobject
pagination.has_morebool
pagination.next_keystring

限制范围 ​

  • 支持市场:HK / US / SG / JP / CA / AU 正股。
  • 不支持:SH / SZ(A 股)及 ETF / 指数 / 窝轮 / 期权 / 期货等。

错误码 ​

ret_codeerror.code触发条件处理建议
0—成功—
-3invalid_parameter参数类型错 / 越界 / 枚举非法校正后重试
-7invalid_symbolsymbol 解析不到证券通过搜索确认代码合法性
-10no_data合法请求但无股东明细确认标的/过滤条件在支持范围
-2 / -4 / -6internal_error服务错误稍后重试,持续失败联系支持

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "holders": [
      {
        "period_text": "2026/Q2",
        "holder_id": 337488017,
        "name": "Prosus Ventures N.V.",
        "holder_quantity": 2079512000,
        "holder_quantity_change": 0,
        "holder_pct": 23.087,
        "holder_pct_change": 0,
        "holding_date": 1767110400000,
        "holding_date_str": "2025-12-31",
        "close_price": 491.3,
        "price_change_pct": 2.6321,
        "source_group_name": "Annual Report",
        "update_time": 1780677957000,
        "update_time_str": "2026-06-06 00:45:57"
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "2"
  }
}