Skip to content

机构持股 ​

GET /api/v1.0/quote/{symbol}/shareholders/institutional

获取个股的机构持股统计(按报告期聚合),返回每期机构数量、合计持股数量与比例及其环比变化,并附报告期收盘/开盘/昨收价。

请求参数 ​

参数类型位置必填说明
symbolstring路径是证券代码,如 HK.00700。
limitint查询否每页返回的报告期数量。默认 10,最大 50。
next_keystring查询否翻页游标,首页留空。

请求示例 ​

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

响应字段 ​

参数类型说明
dataobject
data.holdersobject[]
data.holders[].period_textstring报告期文本(按季度,
data.holders[].institution_quantityint机构数量,例: 861
data.holders[].institution_quantity_changeint机构数量环比变化,例: -4
data.holders[].holder_quantityint机构合计持股数量(股),例: 4210968623
data.holders[].holder_quantity_changeint机构持股数量环比变化(股),例: 3889358
data.holders[].holder_pctnumber机构合计持股比例(百分数),例: 46.682
data.holders[].holder_pct_changenumber机构持股比例环比变化(百分数),例: 0.06
data.holders[].close_pricenumber该报告期收盘价(按报告币种),例: 491.3
data.holders[].open_pricenumber该报告期开盘价(按报告币种),例: 485.0
data.holders[].last_close_pricenumber该报告期昨收价(按报告币种),例: 488.6
data.holders[].update_timeint数据更新时间,毫秒时间戳,例: 1780203883000
data.holders[].update_time_strstring数据更新时间字符串(按市场时区),格式 yyyy-MM-dd HH:mm:ss,例: '2026-05-31 13:04:43'
paginationobject
pagination.has_morebool
pagination.next_keystring

限制范围 ​

  • 支持市场:HK / US / CA / AU / SG / JP。
  • 不支持:A 股(SH/SZ/BJ)、指数、期货、期权、债券等。

错误码 ​

ret_codeerror.code触发条件处理建议
0—成功—
-3invalid_parametersymbol 格式非法 / limit 越界校正请求参数后重试
-7invalid_symbol代码无法解析为证券通过 search 接口确认代码合法性
-10no_data标的可解析但无机构持股数据该标的无机构持股数据,无需重试

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "holders": [
      {
        "period_text": "2026/Q2",
        "institution_quantity": 862,
        "institution_quantity_change": -2,
        "holder_quantity": 4478792804,
        "holder_quantity_change": 269027594,
        "holder_pct": 49.72,
        "holder_pct_change": 3.068,
        "close_price": 491.3,
        "open_price": 498.7,
        "last_close_price": 478.7,
        "update_time": 1780739688000,
        "update_time_str": "2026-06-06 17:54:48"
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "next_key": "1767196799"
  }
}