【别再到处找免费股票数据API了：官方204个接口，32篇一次讲透 #27】基金列表ETF去哪筛？5个接口，全市场基金+盘中估值一次取

【别再到处找免费股票数据API了：官方204个接口，32篇一次讲透 #27】基金列表ETF去哪筛？5个接口，全市场基金+盘中估值一次取

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

1. 你将得到什么

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

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

2. 本篇取数约定

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

3. 5 个端点分 2 组

先建立地图。基金列表与筛选一共 5 个端点，按用途分：

4. 核心模板函数

import requests, time
from urllib.parse import quote

BASE = "https://api.zhituapi.com"
TOKEN = "你的token"

# ———- 1. 字段容错与类型归一 ———-
def _hit_key(d, *cands, default=None):
"""字段容错：接口偶发大小写/中英文混用时，按顺序取第一个非空值"""
if not isinstance(d, dict):
return default
for c in cands:
if c in d and d[c] not in (None, "", "-", "null"):
return d[c]
low = {str(k).lower(): v for k, v in d.items()}
for c in cands:
v = low.get(str(c).lower())
if v not in (None, "", "-", "null"):
return v
return default

def _to_float(v, default=None):
try:
if v in (None, "", "-", "null", "None"):
return default
return float(v)
except (TypeError, ValueError):
return default

# ———- 2. 统一请求：重试 + 退避 ———-
def _get(path, params=None, timeout=10, retries=2, backoff=0.6, default=None):
"""返回 JSON；失败重试 retries 次仍失败则返回 {'_error': 原因}"""
q = {"token": TOKEN}
if params:
q.update(params)
last = ""
for i in range(retries + 1):
try:
r = requests.get(BASE + path, params=q, timeout=timeout)
if r.status_code == 200:
try:
return r.json()
except ValueError:
return default
last = "HTTP %s %s" % (r.status_code, (r.text or "").strip()[:80])
except Exception as e:
last = "%s: %s" % (type(e).__name__, e)
if i < retries:
time.sleep(backoff * (i + 1))
return {"_error": last}

def fetch_jh_list_all(): return _get("/jh/list/all", default=[])
def fetch_fund_list_all(): return _get("/fund/list/all", default=[])
def fetch_fund_list_etf(): return _get("/fund/list/etf", default=[])
def fetch_jh_gz_gz(): return _get("/jh/gz/gz", default=[])
def fetch_jh_gz_zx(): return _get("/jh/gz/zx", default=[])

# ———- 3. 校验 ———-
def run_check():
assert _hit_key({"Code": "000001", "Name": "平安银行"}, "code", "dm") == "000001"
assert _to_float("-") is None and _to_float("12.5") == 12.5
enc = "/x/%s" % quote("示例")
assert "示例" not in enc and "%" in enc
print("校验通过")

if __name__ == "__main__":
run_check()
print("-" * 62)
for name, path in [
("基金列表", "/jh/list/all"),
("全部基金", "/fund/list/all"),
("ETF列表", "/fund/list/etf"),
("盘中估值", "/jh/gz/gz"),
("最新估值", "/jh/gz/zx")
]:
data = _get(path, default=[])
if isinstance(data, dict) and "_error" in data:
print("%-12s %-40s -> %s" % (name, path, data["_error"][:60]))
else:
print("%-12s %-40s -> %d 条" % (name, path, len(data)))

5. 跑通示例

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

6. 坑与注意事项

坑 1：列表与概况不同。
/jh/list/all 与 /fund/list/all 字段不同，一个是净值一个是概况。

坑 2：ETF用前者。
ETF列表 /fund/list/etf 和基金列表要区分，做 ETF 策略用前者。

坑 3：估值是估算。
盘中估值 /jh/gz/gz 是估算值，收溢以官方净值为准。

7. 小结与下篇预告

本篇把基金列表类 5 个端点分成 2 组，给出基金列表与估值的代码，并用 run_check 验证字段容错。

下一篇：《【别再到处找免费股票数据API了：官方204个接口，32篇一次讲透 #28】基金K线ETF行情去哪查？7个接口，K线+MA指标全拿》：用本篇同组接口，把下一类数据一次取全。

8. 免责声明

本文仅演示基金列表与筛选数据的取数方法，所有代码示例均为演示数据，未含任何真实行情数值，不构成投资建议，亦不承诺收益。