企业官网建设流程全解析

【别再到处找免费股票数据API了：官方204个接口，32篇一次讲透 #32】基金分红规模去哪看？9个接口，分红+规模+代销全拉

系列：别再到处找免费股票数据API了：官方204个接口，32篇一次讲透｜连载项目 · 纯 GET 取数 · 仅依赖 requests
适用：做量化 / 选股 / 复盘，但还在手动导 CSV、网页复制、自写爬虫的读者。本篇给基金分红·规模·其他的 9 个端点的分组地图、分红/规模/代销的代码，全部只依赖 requests，所有示例均为演示数据，不构成投资建议。

1. 你将得到什么

读完这一篇，你能拿走四样东西：

1. 一张分组地图：9 个端点按用途分组，知道什么数据该敲哪个门；
2. 一行取数的代码：主要端点一次返回，不用循环拼装；
3. 分红口径与规模时点值的坑；
4. 三个真实踩坑点，都是第一次用几乎一定会踩的。

代码全部自包含，复制进.py直接能跑，不依赖 numpy / pandas。

2. 本篇取数约定

• 全部接口都是GET + query 参数，token 放在查询串里（?token=xxx）；
• 统一基址https://api.zhituapi.com；
• 代码块里的你的token是占位符，换成你的 token 即可；
• 所有接口路径均取自官方已验证文档，跨篇零重复。

3. 9 个端点分 3 组

先建立地图。基金分红·规模·其他一共 9 个端点，按用途分：

4. 核心模板函数

importrequests,timefromurllib.parseimportquote BASE="https://api.zhituapi.com"TOKEN="你的token"# ---------- 1. 字段容错与类型归一 ----------def_hit_key(d,*cands,default=None):"""字段容错：接口偶发大小写/中英文混用时，按顺序取第一个非空值"""ifnotisinstance(d,dict):returndefaultforcincands:ifcindandd[c]notin(None,"","-","null"):returnd[c]low={str(k).lower():vfork,vind.items()}forcincands:v=low.get(str(c).lower())ifvnotin(None,"","-","null"):returnvreturndefaultdef_to_float(v,default=None):try:ifvin(None,"","-","null","None"):returndefaultreturnfloat(v)except(TypeError,ValueError):returndefault# ---------- 2. 统一请求：重试 + 退避 ----------def_get(path,params=None,timeout=10,retries=2,backoff=0.6,default=None):"""返回 JSON；失败重试 retries 次仍失败则返回 {'_error': 原因}"""q={"token":TOKEN}ifparams:q.update(params)last=""foriinrange(retries+1):try:r=requests.get(BASE+path,params=q,timeout=timeout)ifr.status_code==200:try:returnr.json()exceptValueError:returndefault last="HTTP %s %s"%(r.status_code,(r.textor"").strip()[:80])exceptExceptionase:last="%s: %s"%(type(e).__name__,e)ifi<retries:time.sleep(backoff*(i+1))return{"_error":last}deffetch_js_jf_kffh():return_get("/js/jf/kffh",default=[])deffetch_js_jf_fbfh():return_get("/js/jf/fbfh",default=[])deffetch_js_jf_fzfh():return_get("/js/jf/fzfh",default=[])deffetch_js_gm_kfgm():return_get("/js/gm/kfgm",default=[])deffetch_js_gm_fbgm():return_get("/js/gm/fbgm",default=[])deffetch_js_gm_fzgm():return_get("/js/gm/fzgm",default=[])deffetch_js_other_jjzc():return_get("/js/other/jjzc",default=[])deffetch_js_other_zcbd():return_get("/js/other/zcbd",default=[])deffetch_js_other_dxjg():return_get("/js/other/dxjg",default=[])# ---------- 3. 校验 ----------defrun_check():assert_hit_key({"Code":"000001","Name":"平安银行"},"code","dm")=="000001"assert_to_float("-")isNoneand_to_float("12.5")==12.5enc="/x/%s"%quote("示例")assert"示例"notinencand"%"inencprint("校验通过")if__name__=="__main__":run_check()print("-"*62)forname,pathin[("开放式分红","/js/jf/kffh"),("封闭式分红","/js/jf/fbfh"),("分级分红","/js/jf/fzfh"),("开放式规模","/js/gm/kfgm"),("封闭式规模","/js/gm/fbgm"),("分级规模","/js/gm/fzgm"),("基金资产","/js/other/jjzc"),("资产变动","/js/other/zcbd"),("代销机构","/js/other/dxjg")]:data=_get(path,default=[])ifisinstance(data,dict)and"_error"indata:print("%-12s %-40s -> %s"%(name,path,data["_error"][:60]))else:print("%-12s %-40s -> %d 条"%(name,path,len(data)))

5. 跑通示例

把上面的代码复制到本地，填入你的 token 即可直接运行：它会请求对应接口、拉取真实数据，并输出各端点的条数（各字段含义见前文各小节）。

6. 坑与注意事项

坑 1：分红口径。
分红 /js/jf/* 有「每10股派X元」口径，别和绝对金额混。

坑 2：规模是时点值。
规模 /js/gm/* 是时点值，环比要看变动。

坑 3：代销机构会变。
代销机构 /js/other/dxjg 列表会变，取最新。

7. 小结与下篇预告

本篇把基金分红规模类 9 个端点分成 3 组，给出分红/规模/代销的代码，并用 run_check 验证字段容错，系列至此完结。

系列完结：本系列 32 篇已全部讲透官方 204 个接口（沪深A股 / 沪深指数 / 沪深数据 / 京市A股 / 科创行情 / 基金行情），更多实战见官网博客。

8. 免责声明

本文仅演示基金分红·规模·其他数据的取数方法，所有代码示例均为演示数据，未含任何真实行情数值，不构成投资建议，亦不承诺收益。