基金数据域目前覆盖主数据和行情两个基础层级。对产品页面、基金列表和价格查询场景，这已经足够构成一套稳定的基础接口。
基金目录
GET
/api/v1/fundsList funds
listFunds
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| market | query | MarketId | 否 | — |
| code | query | string | 否 | — |
| name | query | string | 否 | — |
| page[size] | query | integer (default 100) | 否 | — |
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | Fund collection | InstrumentCollectionResponse |
| 400 | Invalid request parameters | ErrorResponse |
| 401 | Unauthorized | ErrorResponse |
GET
/api/v1/funds/{instrument_id}Get one fund
getFund
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | Fund resource | InstrumentResponse |
| 401 | Unauthorized | ErrorResponse |
| 404 | Resource not found | ErrorResponse |
基金行情
GET
/api/v1/funds/{instrument_id}/quotesList fund quotes
listFundQuotes
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| instrument_id | path | string | 是 | — |
| from | query | string (date-time) | 否 | — |
| to | query | string (date-time) | 否 | — |
| date | query | string (date) | 否 | — |
| page[size] | query | integer (default 100) | 否 | — |
| 状态码 | 说明 | Schema |
|---|---|---|
| 200 | Quote collection | QuoteCollectionResponse |
| 400 | Invalid request parameters | ErrorResponse |
| 401 | Unauthorized | ErrorResponse |
QuoteCollectionResponse
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data | Array<Quote> | 是 | — |
| data[].instrument_id | string | 是 | — |
| data[].market | string | 是 | — |
| data[].asset_class | string | 是 | — |
| data[].timestamp | string (date-time) | 是 | — |
| data[].price | string | null | 否 | — |
| data[].open | string | null | 否 | — |
| data[].high | string | null | 否 | — |
| data[].low | string | null | 否 | — |
| data[].previous_close | string | null | 否 | — |
| data[].amount | string | null | 否 | — |
| data[].volume | string | null | 否 | — |
| data[].change | string | null | 否 | — |
| data[].change_percent | string | null | 否 | — |
| meta | Meta | 是 | — |
| meta.next_cursor | string | null | 是 | — |
| links | SelfLinks | 是 | — |
| links.self | string | 是 | — |
查询基金行情bash
curl "https://heliumlabz.com/api/v1/funds/161725.SZ/quotes?from=2026-03-01&to=2026-03-31" \
-H "X-API-Key: $ASHARE_API_KEY"