跳到主要内容
基金数据 API

全市场筛选

/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—stringscale排序:1w/1m/3m/6m/1y/2y/3y/5y/ytd/since/scale/nav/inception/morningstar
order—stringdescdesc / asc
page—int1页码,从 1 起
size—int50每页条数,1–200

响应字段

字段类型说明
total / pagesint符合条件总数 / 总页数
countint本次返回条数
filtersobject回显本次生效的全部筛选条件
list[].code / namestring代码 / 全名
list[].type_id / type_name / sub_type_id / sub_type_namestring类型 id 与名称
list[].company / subjectstring基金公司 / 主题
list[].inception_date / nav / acc_nav / scale_yimixed成立日 / 单位净值 / 累计净值 / 规模(亿)
list[].returnsobject多期收益:w1 / m1 / m3 / m6 / y1 / y3 / y5 / ytd / since_inception
list[].ratingsobject各家评级: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 会被当成非法值或筛出空结果。

评级筛选用的是「当期有评级」的基金

按某机构评级筛选时,该机构未评级的基金不会被命中 —— 这是筛选的正常行为,不是数据缺失。