Skip to main content
Fund Data API

Screener options

/v1/fund-screener-optionsFree

Returns every legal value a whole-market screener accepts: type tree, fund companies, themes, return buckets, rating agencies and sort fields. Free endpoint.

Answers: Before building a screener, which types, companies, themes and return buckets are available?

Request parameters

ParameterRequiredTypeDefaultDescription
key—string—API key (optional for a free endpoint)

Response fields

FieldTypeDescription
typesarrayCategory and sub-type tree; types[].children holds the children
companiesarrayFund company list (id and Chinese name)
subjectsarrayTheme list (code and name)
return_rangesarrayReturn buckets keyed w4 / w13 / w26 / w52 / y2 / y3 / y5 / yn
ratingsobjectRating agency list
sortsarraySortable fields (key and field name)

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-options",
  "tier": "institutional",
  "elapsed_ms": 823,
  "data": {
    "types": [
      {
        "id": "x2001",
        "name": "混合型",
        "children": [
          {
            "id": "x3004",
            "name": "稳健混合型"
          },
          {
            "id": "x3006",
            "name": "激进混合型"
          },
          {
            "id": "x3026",
            "name": "平衡混合型"
          }
        ]
      },
      {
        "id": "x2003",
        "name": "债券型",
        "children": [
          {
            "id": "x3003",
            "name": "稳健债券型"
          },
          {
            "id": "x3005",
            "name": "激进债券型"
          },
          {
            "id": "x3012",
            "name": "纯债债券型"
          }
        ]
      },
      {
        "id": "x2002",
        "name": "股票型",
        "children": [
          {
            "id": "x3008",
            "name": "指数型"
          },
          {
            "id": "x3007",
            "name": "一般股票型"
          },
          {
            "id": "x3006",
            "name": "激进混合型"
          }
        ]
      }
    ],
    "companies": [
      {
        "id": "80163340",
        "name": "安信基金",
        "pinyin": "axjj"
      },
      {
        "id": "82873649",
        "name": "安联基金",
        "pinyin": "aljj"
      },
      {
        "id": "80000226",
        "name": "博时基金",
        "pinyin": "bsjj"
      }
    ],
    "subjects": [
      {
        "code": "S13",
        "name": "定期开放"
      },
      {
        "code": "S15",
        "name": "货币t+0"
      },
      {
        "code": "S6",
        "name": "大盘蓝筹"
      }
    ],
    "return_ranges": [
      {
        "key": "yn",
        "name": "今年来",
        "buckets": {
          "1": "0~10%",
          "2": "10%~20%",
          "3": "20%~50%",
          "4": "50%以上",
          "5": "负收益"
        }
      },
      {
        "key": "w4",
        "name": "近1月",
        "buckets": {
          "1": "0~10%",
          "2": "10%~20%",
          "3": "20%~50%",
          "4": "50%以上",
          "5": "负收益"
        }
      },
      {
        "key": "w13",
        "name": "近3月",
        "buckets": {
          "1": "0~10%",
          "2": "10%~20%",
          "3": "20%~50%",
          "4": "50%以上",
          "5": "负收益"
        }
      }
    ],
    "ratings": [
      {
        "key": "morningstar",
        "name": "晨星"
      },
      {
        "key": "haitong",
        "name": "海通"
      },
      {
        "key": "jianxin",
        "name": "济安金信"
      }
    ],
    "sorts": [
      {
        "key": "1w",
        "field": "w1navg"
      },
      {
        "key": "1m",
        "field": "w4navg"
      },
      {
        "key": "3m",
        "field": "w13navg"
      }
    ],
    "method": "types / companies / subjects 是数据源给的原值;return_ranges / ratings / sorts 的 key 是本接口的参数名,buckets 是数据源页面上那五档的原文。",
    "note": "同一只基金的 A/C/E 等份额在数据源里是各自独立的一条,本接口不去重,筛出来看到同一只基金多个份额属正常。"
  }
}

Example call

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

Notes

This is the dictionary — call it before screening

Every id-style parameter of `/v1/fund-screener` (type / sub_type / company / subject) must come from here. Guessing ids yields empty results.

Return ranges are bucket numbers, not values

`return_ranges` gives buckets numbered 1–5 (1 = 0–10%). Pass the bucket number, not a percentage.