Fund search
/v1/fund-searchFreeFuzzy 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
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
q | ✅ | string | — | Search term: code / name / pinyin initials, 1–50 characters |
limit | — | int | 20 | Rows to return, 1–50 |
key | — | string | — | API key (optional for a free endpoint; anonymous calls are rate limited more strictly) |
Response fields
| Field | Type | Description |
|---|---|---|
keyword | string | Echo of the search term |
count | int | Number of rows returned this call |
list[].code | string | 6-digit fund code |
list[].name | string | Full fund name |
list[].type | string | Type description |
list[].pinyin | string | Pinyin initials (uppercase) |
list[].category_code | int | Numeric 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.