【别再到处找免费股票数据API了：官方204个接口，32篇一次讲透 #31】基金业绩排行靠搜？3个接口，股混债QDII业绩榜一次取
系列：别再到处找免费股票数据API了：官方204个接口，32篇一次讲透｜连载项目 · 纯 GET 取数 · 仅依赖 requests
适用：做量化 / 选股 / 复盘，但还在手动导 CSV、网页复制、自写爬虫的读者。本篇给基金业绩排行的 3 个端点的分组地图、股混债/QDII业绩榜的代码，全部只依赖 requests，所有示例均为演示数据，不构成投资建议。
1. 你将得到什么
读完这一篇，你能拿走四样东西：
- 一张分组地图：3 个端点按用途分组，知道什么数据该敲哪个门；
- 一行取数的代码：主要端点一次返回，不用循环拼装；
- 跨类对比基准与杠杆风险的坑；
- 三个真实踩坑点，都是第一次用几乎一定会踩的。
代码全部自包含，复制进.py直接能跑，不依赖 numpy / pandas。
2. 本篇取数约定
- 全部接口都是GET + query 参数，token 放在查询串里（
?token=xxx）； - 统一基址
https://api.zhituapi.com； - 代码块里的
你的token是占位符，换成你的 token 即可； - 所有接口路径均取自官方已验证文档，跨篇零重复。
3. 3 个端点分 2 组
先建立地图。基金业绩排行一共 3 个端点，按用途分：
| 组 | 端点 | 用途 | 更新频率 |
|---|---|---|---|
| 开放 | /js/pm/kfpm | 开放式排行 | 每日盘后 |
| 封闭 | /js/pm/fbpm | 封闭式排行 | 每日盘后 |
| 分级 | /js/pm/fzyj | 分级业绩 | 每日盘后 |
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_pm_kfpm():return_get("/js/pm/kfpm",default=[])deffetch_js_pm_fbpm():return_get("/js/pm/fbpm",default=[])deffetch_js_pm_fzyj():return_get("/js/pm/fzyj",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/pm/kfpm"),("封闭式排行","/js/pm/fbpm"),("分级业绩","/js/pm/fzyj")]: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：跨类对比小心。
股混债 QDII 业绩榜口径不同，跨类对比要小心。
坑 2：确认基准区间。
业绩排行用「今年以来/近一年」等不同基准，确认区间。
坑 3：分级含杠杆。
分级基金业绩 /js/pm/fzyj 含杠杆，风险不同。
7. 小结与下篇预告
本篇把基金业绩排行类 3 个端点分成 2 组，给出业绩榜的代码，并用 run_check 验证字段容错。
下一篇：《【别再到处找免费股票数据API了：官方204个接口，32篇一次讲透 #32】基金分红规模去哪看？9个接口，分红+规模+代销全拉》：用本篇同组接口，把下一类数据一次取全。
8. 免责声明
本文仅演示基金业绩排行数据的取数方法，所有代码示例均为演示数据，未含任何真实行情数值，不构成投资建议，亦不承诺收益。
