跳到主要内容

基金持有人数据

通用约定
  • Base URL：https://fuyao.aicubes.cn。
  • 必需请求头：X-api-key；认证与权限错误通过业务 code 表达。
  • 本页接口返回统一 ApiResponse 信封；时间戳均为毫秒级 Unix 时间戳，时区按 Asia/Shanghai。
  • thscode 是基金唯一标识，必须保留市场后缀。占比字段为百分数原值，例如 8.88 表示 8.88%。

基金持有人结构​

GET /api/fund/holders/detail

MCP Tool：get_fund_holders_detail

请求参数​

参数类型必需默认值说明
thscodestring是—完整基金 thscode，必须保留市场后缀。
merge_scopeenum否allall（分别返回合并/独立份额的最新记录）/ merged（A/C 等份额合并披露）/ separate（当前份额独立披露）。

请求示例​

curl 'https://fuyao.aicubes.cn/api/fund/holders/detail?thscode=161725.SZ&merge_scope=all' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "efcdf379c79349ec8a2eb7bdf0d27882",
  "data": {
    "timestamp": 1767110400000,
    "item": [
      {
        "merge_scope": "merged",
        "report_date_ms": 1609344000000,
        "ins_position": 0.1800,
        "holder_amount": 7058156,
        "avg_holder_share": 4819.4200,
        "psnl_rate": 99.8200,
        "mgmt_staff_hold_rate": 0.0062
      },
      {
        "merge_scope": "separate",
        "report_date_ms": 1767110400000,
        "ins_position": 0.9700,
        "holder_amount": 3951034,
        "avg_holder_share": 10159.8300,
        "psnl_rate": 99.0300,
        "mgmt_staff_hold_rate": 0.0097
      }
    ]
  }
}

返回字段​

data.item[] 字段：

字段类型说明
merge_scopestring该条记录的实际披露口径：merged 或 separate。
report_date_msinteger该条记录的披露报告日，毫秒 Unix 时间戳。
ins_positionnumber机构投资者占比，百分数原值。
holder_amountinteger基金份额持有人户数。
avg_holder_sharenumber平均每户持有基金份额。
psnl_ratenumber个人投资者占比，百分数原值。
mgmt_staff_hold_ratenumber管理人员工持有比例，百分数原值。

merge_scope=all 时 item 最多包含两条：merged 和 separate 口径各自报告日最新的记录。指定单一口径时最多返回一条。data.timestamp 取返回记录中最新的报告日；所选口径暂无可用数据时返回 code=3002。

基金前十大持有人​

GET /api/fund/holders/top

MCP Tool：get_fund_holders_top

请求参数​

参数类型必需默认值说明
thscodestring是—完整基金 thscode。
limitinteger否服务端默认返回条数，最大为 10。

请求示例​

curl 'https://fuyao.aicubes.cn/api/fund/holders/top?thscode=510300.SH&limit=10' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "e4a3af1cf0b14210b98d023297740324",
  "data": {
    "timestamp": 1786690800000,
    "limit": 10,
    "item": [
      {
        "holder_id": "holder-001",
        "holder_code": "H001",
        "holder_name": "示例持有人",
        "holder_type": "institution",
        "rank": 1,
        "hold_share": 125000000,
        "hold_rate_pct": 8.25,
        "report_date_ms": 1785513600000,
        "publish_date_ms": 1786118400000
      }
    ]
  }
}

返回字段​

data 元数据：

字段类型说明
timestamplong接口响应时间戳，毫秒 Unix 时间戳。
limitinteger服务端实际采用的返回条数上限。

data.item[] 字段：

字段类型说明
holder_id / holder_codestring持有人 ID 与代码。
holder_namestring持有人名称。
holder_typestring持有人类型。
rankinteger持有排名。
hold_sharenumber持有份额。
hold_rate_pctnumber持有比例，百分数原值。
report_date_ms / publish_date_mslong报告日与发布日期，毫秒 Unix 时间戳。

通用参数与错误码参见基金 API 总览。