基金持有人结构 在线试调 →
基金持有人结构: 户数/机构占比 — 筹码结构因子底座
接口说明
基金持有人结构(季频):持有人户数/机构持有占比/总份额 — 筹码结构因子底座。
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"]])
最新期户数榜
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/jj_holder",
headers={"X-API-Key": KEY},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
单基金结构全序列
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/jj_holder",
headers={"X-API-Key": KEY},
params={"code": "sz510050"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
最新期户数榜
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/jj_holder"
单基金结构全序列
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/jj_holder?code=sz510050"
输入参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| code | str | 可选 | 基金代码(前缀码, 如 sz510050/sh562400/bj400001); 与bgq同给以code优先 |
| bgq | str | 可选 | 报告期 YYYY-MM-DD(期榜模式, 缺省=最新期) |
| limit | int | 可选 | 期榜返回条数上限, 默认50(≤2000) |
| fields | str | 可选 | 挑列: 逗号分隔列名(如 fields=bgq,holders,inst_pct); 不存在的列被忽略 |
返回字段
| 名称 | 类型 | 描述 |
|---|---|---|
| periods | array | 可用报告期清单 |
| rows[].bgq / code / name | str | 报告期/代码(带市场前缀)/简称 |
| rows[].holders | int | 持有人户数 |
| rows[].inst_pct | float | 机构持有占比(%) |
| rows[].shares | int | 总份额(份) |
返回数据样例
{
"periods": [
"2026-09-30",
"2026-06-30",
"2025-12-31"
],
"code": "sz510050",
"mode": "code",
"total": 0,
"rows": [],
"note": "该基金暂无记录(未披露/非统计期)"
}
样例取自平台数据,periods共 15 条,样例仅展示前 3 条。
最佳实践:机构占比骤升=筹码向机构集中; 户数下降+机构占比升=筹码集中化(常先于价格启动); 季频披露有滞后, 适合低频因子层。