Skip to content

持股变动 ​

GET /api/v1.0/quote/{symbol}/shareholders/holding-changes

获取指定证券的股东持股变动记录,支持按增减持方向筛选、多维度排序与分页。

请求参数 ​

参数类型位置必填说明
symbolstring路径是证券代码(路径参数),格式 MARKET.CODE,例: HK.00700 最长长度 32; 格式 ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$
limitint查询否每页条数,默认 30,最大 50 ≤ 50; 默认 30
next_keystring查询否翻页游标(首页留空)。回传上一页 pagination.next_key;以 pagination.has_more=false 停止 最长长度 1000; 格式 ^$|^(-?[0-9]+)?$
sort_columnint查询否排序列,默认 1。1=变动数 / 2=持股日期 / 3=变动比例 / 4=变动金额 / 5=持股比例 默认 1; 取值 1, 2, 3, 4, 5
sort_typeint查询否排序方向,默认 0。0=desc(降序)/ 1=asc(升序) 默认 0; 取值 0, 1
filter_typeint查询否增减持筛选,默认 0。0=不筛选 / 1=增持 / 2=减持 / 3=建仓 / 4=清仓 默认 0; 取值 0, 1, 2, 3, 4
holder_categorystring查询否持有人范围,默认 INSTITUTIONS(机构,OwnershipType 1~15)。INDIVIDUALS=个人 / CORPORATIONS=公司法人 / ALL=全部 默认 "INSTITUTIONS"; 取值 INSTITUTIONS, INDIVIDUALS, CORPORATIONS, ALL

请求示例 ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/shareholders/holding-changes?limit=2&holder_category=ALL&filter_type=1" | jq

响应字段 ​

参数类型说明
dataobject
data.changesobject[]
data.changes[].period_textstring报告期文本(按季度),格式 'YYYY/QN',例: '2026/Q2'
data.changes[].namestring股东名称,例: 'CSOP Asset Management Limited'
data.changes[].holder_idint股东 ID(int),例: 112337755
data.changes[].share_change_numint持股变动数量(股,正为增持/负为减持),例: 3403156
data.changes[].shares_change_priceint变动金额(按报告币种),例: 1502153058
data.changes[].share_rationumber持股比例(百分数),例: 0.193
data.changes[].holder_typestring股东类型文本(英文,按 OwnershipType 枚举映射),例: 'Traditional Investment Manager'
data.changes[].holder_type_idnumber股东类型 ID,例: 2
data.changes[].holding_dateint持股日期,毫秒时间戳,例: 1777824000000
data.changes[].holding_date_strstring持股日期字符串,格式 yyyy-MM-dd,例: '2026-05-03'
data.changes[].share_ratio_changenumber持股比例变动(百分数),例: 0.038
data.changes[].share_numint当前持股数量(股),例: 17322076
paginationobject
pagination.has_morebool
pagination.next_keystring

限制范围 ​

  • 市场:HK / US / JP / SG / CA / AU 的正股;A 股服务端无持股数据。
  • 品类:仅正股有数据。
  • 无数据返回 no_data。

错误码 ​

ret_codeerror.code触发条件处理建议
0—成功—
-3invalid_parametersymbol 格式非法 / 参数越界校正参数后重试
-7invalid_symbol代码合法但查不到证券用 search 接口确认代码合法性
-10no_data合法证券但无持股变动数据该标的无持股数据,无需重试

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "changes": [
      {
        "name": "CSOP Asset Management Limited",
        "holder_id": 112337755,
        "holder_type": "Traditional Investment Manager",
        "holder_type_id": 2,
        "period_text": "2026/Q2",
        "holding_date": 1777824000000,
        "holding_date_str": "2026-05-03",
        "share_change_num": 3478154,
        "share_num": 17397074,
        "share_ratio": 0.193,
        "share_ratio_change": 0.038,
        "shares_change_price": 1576299392
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "30"
  }
}