全市场筛选
/v1/fund-screener机构版多条件组合筛选全市场基金,返回净值、规模、多期收益与各家评级。所有 id 型取值来自「筛选项字典」。机构版可用。
回答的问题:按类型、公司、主题、收益区间、机构评级,筛出符合条件的基金。
请求参数
| 参数 | 必填 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
type | — | string | — | 大类 id,如 x2002(股票型),取值见 fund-screener-options |
sub_type | — | string | — | 细分 id,如 x3008(指数型) |
company | — | string | — | 基金公司 id 或中文名,如 80000229 / 易方达基金 |
subject | — | string | — | 主题 code,如 S20(医药主题) |
w4 / w13 / w26 / w52 | — | int | — | 近 1 月 / 3 月 / 6 月 / 1 年收益档位 1–5,0 = 不筛 |
y2 / y3 / y5 / yn | — | int | — | 近 2 年 / 3 年 / 5 年 / 今年来收益档位 1–5,0 = 不筛 |
morningstar / haitong / jianxin / zhaoshang / yinhe3 / yinhe5 | — | int | — | 各机构评级 1–5 星,0 = 不筛 |
sort | — | string | scale | 排序:1w/1m/3m/6m/1y/2y/3y/5y/ytd/since/scale/nav/inception/morningstar |
order | — | string | desc | desc / asc |
page | — | int | 1 | 页码,从 1 起 |
size | — | int | 50 | 每页条数,1–200 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
total / pages | int | 符合条件总数 / 总页数 |
count | int | 本次返回条数 |
filters | object | 回显本次生效的全部筛选条件 |
list[].code / name | string | 代码 / 全名 |
list[].type_id / type_name / sub_type_id / sub_type_name | string | 类型 id 与名称 |
list[].company / subject | string | 基金公司 / 主题 |
list[].inception_date / nav / acc_nav / scale_yi | mixed | 成立日 / 单位净值 / 累计净值 / 规模(亿) |
list[].returns | object | 多期收益:w1 / m1 / m3 / m6 / y1 / y3 / y5 / ytd / since_inception |
list[].ratings | object | 各家评级:morningstar / haitong / jianxin / zhaoshang / yinhe3 / yinhe5 |
真实响应样例
用 110022 实抓的真实响应。列表类字段已截短以便阅读(原始响应更完整); 其中的 elapsed_ms 是某一次的耗时,首次请求通常 1–3 秒。
{
"ok": true,
"endpoint": "fund-screener",
"tier": "institutional",
"elapsed_ms": 1043,
"data": {
"total": 32312,
"page": 1,
"size": 3,
"count": 3,
"pages": 10771,
"list": [
{
"code": "000198",
"name": "天弘余额宝货币",
"type_id": "x2005",
"type_name": "货币型",
"sub_type_id": "x3019",
"sub_type_name": "货币A",
"company": "天弘基金",
"subject": "货币t+0",
"inception_date": "2013-05-29",
"nav": 0.2125,
"acc_nav": 0.798,
"scale_yi": 6451.36,
"returns": {
"w1": 0.02,
"m1": 0.07,
"m3": 0.21,
"m6": 0.42,
"y1": 0.92,
"y3": 3.85,
"y5": 7.51,
"ytd": 0.91,
"since_inception": 40.62
},
"ratings": {
"morningstar": null,
"haitong": null,
"jianxin": 1,
"zhaoshang": null,
"yinhe3": null,
"yinhe5": null
}
},
{
"code": "000686",
"name": "建信嘉薪宝货币A",
"type_id": "x2005",
"type_name": "货币型",
"sub_type_id": "x3019",
"sub_type_name": "货币A",
"company": "建信基金",
"subject": null,
"inception_date": "2014-06-17",
"nav": 0.2777,
"acc_nav": 1.009,
"scale_yi": 4200.17,
"returns": {
"w1": 0.02,
"m1": 0.09,
"m3": 0.26,
"m6": 0.53,
"y1": 1.12,
"y3": 4.45,
"y5": 8.61,
"ytd": 1.11,
"since_inception": 37.88
},
"ratings": {
"morningstar": null,
"haitong": null,
"jianxin": 3,
"zhaoshang": null,
"yinhe3": null,
"yinhe5": null
}
},
{
"code": "000343",
"name": "华夏财富宝货币A",
"type_id": "x2005",
"type_name": "货币型",
"sub_type_id": "x3019",
"sub_type_name": "货币A",
"company": "华夏基金",
"subject": null,
"inception_date": "2013-10-25",
"nav": 0.215,
"acc_nav": 0.889,
"scale_yi": 2993.41,
"returns": {
"w1": 0.02,
"m1": 0.08,
"m3": 0.23,
"m6": 0.47,
"y1": 1.01,
"y3": 4.2,
"y5": 8.11,
"ytd": 1,
"since_inception": 41.57
},
"ratings": {
"morningstar": null,
"haitong": null,
"jianxin": 2,
"zhaoshang": null,
"yinhe3": null,
"yinhe5": null
}
}
],
"filters": {
"type": null,
"sub_type": null,
"company": null,
"subject": null,
"ranges": {},
"ratings": {},
"sort": "scale",
"order": "desc"
},
"method": "全部字段由数据源直接给出,本接口只做参数校验、字段改名和 id→中文名映射,⛔ 不重算收益、不重算评级、不做份额合并。",
"note": "returns 的键名:w1 近1周 / m1 近1月 / m3 近3月 / m6 近6月 / y1 近1年 / y3 近3年 / y5 近5年 / ytd 今年来 / since_inception 成立来。ratings 里 0 表示该机构没给评,统一给 null。能按「近2年」筛(ranges 的 y2),但数据源不返回近2年收益,所以 list 里没有这一项。同一只基金的 A/C/E 份额是各自独立的一条,本接口不去重;结果里也含场内 ETF(159xxx / 512xxx)与香港互认基金(968xxx),只要场外请自行按代码前缀过滤。scale_yi 为 0 表示数据源没给规模,不是「规模为零」,按规模升序时会排在最前面。"
}
}调用示例
curl "https://api.fundapi.cn/v1/fund-screener?code=110022" \ -H "Authorization: Bearer 你的API Key" \ -H "User-Agent: your-app"
注意
id 型参数必须取自筛选项字典
`type` / `sub_type` / `company` / `subject` 猜一个 id 会得到空结果,而不是报错。先调 `/v1/fund-screener-options`。
收益筛选传「档位」不是百分比
`w4` 等参数接受 1–5 的档位编号(含义见 `return_ranges`),⛔ 传 20 会被当成非法值或筛出空结果。
评级筛选用的是「当期有评级」的基金
按某机构评级筛选时,该机构未评级的基金不会被命中 —— 这是筛选的正常行为,不是数据缺失。