基金持有人结构 在线试调 →

基金持有人结构: 户数/机构占比 — 筹码结构因子底座

门槛需要 专业版 及以上

数据基金持有人结构(季频报告期驱动): 持有人户数/机构持有占比/总份额

限制code=基金码(前缀码 sh/sz/bj)全报告期序列 / bgq=期榜(按户数降序) / 双缺省=最新期榜

接口说明

基金持有人结构(季频):持有人户数/机构持有占比/总份额 — 筹码结构因子底座。

code=单基金全报告期序列;bgq=指定期榜(按户数降序);双缺省=最新期榜

机构占比骤升+户数下降=筹码集中化(常先于价格启动)

快速调用

同一调用的三种等价写法,按接入习惯任选其一,复制即可运行。

最新期户数榜
import top369 as gp

pro = gp.pro_api("sk-xxxxxxxxxxxx")   # 安装: pip install top369

df = pro.jj_holder()
print(df.head(20))
单基金结构全序列
import top369 as gp

pro = gp.pro_api("sk-xxxxxxxxxxxx")   # 安装: pip install top369

df = pro.jj_holder(code="sz510050")
print(df[["bgq", "holders", "inst_pct"]])

输入参数

名称类型必填描述
codestr可选基金代码(前缀码, 如 sz510050/sh562400/bj400001); 与bgq同给以code优先
bgqstr可选报告期 YYYY-MM-DD(期榜模式, 缺省=最新期)
limitint可选期榜返回条数上限, 默认50(≤2000)
fieldsstr可选挑列: 逗号分隔列名(如 fields=bgq,holders,inst_pct); 不存在的列被忽略

返回字段

名称类型描述
periodsarray可用报告期清单
rows[].bgq / code / namestr报告期/代码(带市场前缀)/简称
rows[].holdersint持有人户数
rows[].inst_pctfloat机构持有占比(%)
rows[].sharesint总份额(份)

返回数据样例

{
  "periods": [
    "2026-09-30",
    "2026-06-30",
    "2025-12-31"
  ],
  "code": "sz510050",
  "mode": "code",
  "total": 0,
  "rows": [],
  "note": "该基金暂无记录(未披露/非统计期)"
}

样例取自平台数据,periods共 15 条,样例仅展示前 3 条。

最佳实践:机构占比骤升=筹码向机构集中; 户数下降+机构占比升=筹码集中化(常先于价格启动); 季频披露有滞后, 适合低频因子层。

认证方式、代码规范、错误码等通用约定见文档首页; 可在在线测试中直接调试本接口。