Market screener
/v1/fund-screenerInstitutionalCombines 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.
Request parameters
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
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 | — | string | scale | Sort: 1w/1m/3m/6m/1y/2y/3y/5y/ytd/since/scale/nav/inception/morningstar |
order | — | string | desc | desc / asc |
page | — | int | 1 | Page number, starting at 1 |
size | — | int | 50 | Rows per page, 1–200 |
Response fields
| Field | Type | Description |
|---|---|---|
total / pages | int | Total matches / total pages |
count | int | Number of rows returned this call |
filters | object | Echo of every filter that took effect |
list[].code / name | string | Code / full name |
list[].type_id / type_name / sub_type_id / sub_type_name | string | Type ids and names |
list[].company / subject | string | Fund company / theme |
list[].inception_date / nav / acc_nav / scale_yi | mixed | Inception date / unit NAV / accumulated NAV / AUM (100M CNY) |
list[].returns | object | Multi-period returns: w1 / m1 / m3 / m6 / y1 / y3 / y5 / ytd / since_inception |
list[].ratings | object | Agency 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
A guessed id for `type` / `sub_type` / `company` / `subject` returns an empty result rather than an error. Call `/v1/fund-screener-options` first.
Parameters such as `w4` accept buckets 1–5 (meaning defined in `return_ranges`). Passing 20 is treated as invalid or yields nothing.
When filtering by an agency rating, funds that agency did not rate are excluded — that is normal filtering behaviour, not missing data.