Skip to main content
Fund Data API

Market screener

/v1/fund-screenerInstitutional

Combines multiple conditions to screen the whole market and returns NAV, AUM, multi-period returns and agency ratings. Every id-style value comes from the screener options dictionary. Institutional and above.

Answers: Screen by type, company, theme, return bucket and agency rating.

Request parameters

ParameterRequiredTypeDefaultDescription
type—string—Top-level type id, e.g. x2002 (equity); values from fund-screener-options
sub_type—string—Sub-type id, e.g. x3008 (index)
company—string—Fund company id or Chinese name, e.g. 80000229 / 易方达基金
subject—string—Theme code, e.g. S20 (pharma theme)
w4 / w13 / w26 / w52—int—1M / 3M / 6M / 1Y return bucket 1–5, 0 = no filter
y2 / y3 / y5 / yn—int—2Y / 3Y / 5Y / YTD return bucket 1–5, 0 = no filter
morningstar / haitong / jianxin / zhaoshang / yinhe3 / yinhe5—int—Agency rating 1–5 stars, 0 = no filter
sort—stringscaleSort: 1w/1m/3m/6m/1y/2y/3y/5y/ytd/since/scale/nav/inception/morningstar
order—stringdescdesc / asc
page—int1Page number, starting at 1
size—int50Rows per page, 1–200

Response fields

FieldTypeDescription
total / pagesintTotal matches / total pages
countintNumber of rows returned this call
filtersobjectEcho of every filter that took effect
list[].code / namestringCode / full name
list[].type_id / type_name / sub_type_id / sub_type_namestringType ids and names
list[].company / subjectstringFund company / theme
list[].inception_date / nav / acc_nav / scale_yimixedInception date / unit NAV / accumulated NAV / AUM (100M CNY)
list[].returnsobjectMulti-period returns: w1 / m1 / m3 / m6 / y1 / y3 / y5 / ytd / since_inception
list[].ratingsobjectAgency ratings: morningstar / haitong / jianxin / zhaoshang / yinhe3 / yinhe5

Real response sample

Captured live using 110022. List fields are shortened for readability (the real response is longer); elapsed_ms is from that one call — the first request usually takes 1–3 seconds.

{
  "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 表示数据源没给规模,不是「规模为零」,按规模升序时会排在最前面。"
  }
}

Example call

curl "https://api.fundapi.cn/v1/fund-screener?code=110022" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "User-Agent: your-app"

Notes

Id parameters must come from the options dictionary

A guessed id for `type` / `sub_type` / `company` / `subject` returns an empty result rather than an error. Call `/v1/fund-screener-options` first.

Return filters take a bucket number, not a percentage

Parameters such as `w4` accept buckets 1–5 (meaning defined in `return_ranges`). Passing 20 is treated as invalid or yields nothing.

Rating filters only match funds rated in that period

When filtering by an agency rating, funds that agency did not rate are excluded — that is normal filtering behaviour, not missing data.