Skip to main content
Fund Data API

Fund search

/v1/fund-searchFree

Fuzzy search by code, name or pinyin initials; returns codes and full names. Free endpoint — works without a key.

Answers: The user only gave a fund name or pinyin initials — how do I turn that into a code?

Request parameters

ParameterRequiredTypeDefaultDescription
q✅string—Search term: code / name / pinyin initials, 1–50 characters
limit—int20Rows to return, 1–50
key—string—API key (optional for a free endpoint; anonymous calls are rate limited more strictly)

Response fields

FieldTypeDescription
keywordstringEcho of the search term
countintNumber of rows returned this call
list[].codestring6-digit fund code
list[].namestringFull fund name
list[].typestringType description
list[].pinyinstringPinyin initials (uppercase)
list[].category_codeintNumeric category code, cross-referenceable with the screener options

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-search",
  "tier": "institutional",
  "elapsed_ms": 1057,
  "data": {
    "keyword": "易方达",
    "count": 3,
    "list": [
      {
        "code": "110006",
        "name": "易方达货币A",
        "type": "基金",
        "pinyin": "YFDHBA",
        "category_code": 700
      },
      {
        "code": "110016",
        "name": "易方达货币B",
        "type": "基金",
        "pinyin": "YFDHBB",
        "category_code": 700
      },
      {
        "code": "002602",
        "name": "易方达丰惠混合",
        "type": "基金",
        "pinyin": "YFDFHHH",
        "category_code": 700
      }
    ]
  }
}

Example call

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

Notes

`limit` is a cap, not a guarantee

A broad term (for example a single character) matches many funds and is truncated to `limit`. Narrow it down with the full name or the code first.

`category_code` is not a filter id

It is a numeric code meant for cross-referencing with `/v1/fund-screener-options`. Do not pass it back as a screener parameter.