查询场内、场外公募基金资料,默认场外,可用 market 区分。
- 数据范围
- 场内和场外公募基金,market=E/O区分,默认场外
- 包含内容
- 基金名称、管理人、托管人、类型、成立与上市日期、费率和状态等资料
- 时间覆盖
- 非逐日历史快照;每只基金含成立日 found_date、上市日 list_date 等日期,例如 000001.OF 成立于 2001-12-18
- 数据频率
- 基本资料
公募基金列表
POST
https://jinniu.lingxideai.com/api/fund_basic查询场内与场外公募基金基本资料,使用 market 区分。默认 market=O(场外);本接口不是逐日历史快照。
共用“ETF、基金、LOF历史”权限及期限,一次开通即可使用 ETF、LOF 历史和本组公募基金接口;不包含实时权限。覆盖起始日期随基金与数据项不同,以实际可用记录为准,不承诺所有基金全历史完整覆盖。
| 参数 | 必填 | 说明 |
|---|---|---|
| api_key | 是 | 账户 API Key,也可通过 X-Api-Key 请求头传入。 |
| ts_code | 条件见上文 | 基金代码,如 001753.OF、159995.SZ;基金经理支持逗号分隔的多个代码(最多100个),其余接口限单个。 |
| market | 条件见上文 | E 场内、O 场外。基金列表默认 O;净值不填时不限定市场。 |
| status | 条件见上文 | L 存续、I 发行、D 摘牌或到期;不填不限定。 |
| limit | 否 | 1 至 6000,默认 6000;全站设置与本接口上限取较小值。 |
| offset | 否 | 偏移行数,默认0,最大10000000;保持筛选条件不变,按 next_offset 继续。可能有下一页不代表一定还有记录。 |
| fields | 否 | 逗号分隔的返回字段;不填返回默认字段。可选:ts_code,name,management,custodian,fund_type,found_date,due_date,list_date,issue_date,delist_date,issue_amount,m_fee,c_fee,duration_year,p_value,min_amount,exp_return,benchmark,status,invest_type,type,trustee,purc_startdate,redm_startdate,market。 |
调用示例
curl -X POST 'https://jinniu.lingxideai.com/api/fund_basic' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-d '{"limit": 2, "market": "O", "status": "L"}'
返回字段
| 字段 | 说明 |
|---|---|
| ts_code | 基金代码;无单位。 |
| name | 基金名称、管理公司名称或基金经理姓名,依接口区分。 |
| management | 基金管理人。 |
| custodian | 基金托管人。 |
| fund_type | 基金类型。 |
| found_date | 成立日期,YYYYMMDD。 |
| due_date | 到期日期,YYYYMMDD。 |
| list_date | 上市日期,YYYYMMDD。 |
| issue_date | 发行日期,YYYYMMDD。 |
| delist_date | 退市日期,YYYYMMDD。 |
| issue_amount | 发行份额,单位:亿份。 |
| m_fee | 管理费率,单位:%。 |
| c_fee | 托管费率,单位:%。 |
| duration_year | 存续期,单位:年。 |
| p_value | 面值,单位:元/份。 |
| min_amount | 最低申购金额,单位:万元人民币。 |
| exp_return | 预期收益率记录;不是收益保证,单位:%。 |
| benchmark | 业绩比较基准。 |
| status | 存续状态:L 存续、I 发行、D 摘牌或到期。 |
| invest_type | 投资风格。 |
| type | 投资类型。 |
| trustee | 受托人。 |
| purc_startdate | 日常申购起始日,YYYYMMDD。 |
| redm_startdate | 日常赎回起始日,YYYYMMDD。 |
| market | E 场内、O 场外。 |
| data.meta.returned_count / limit / max_rows / offset / next_offset | 本页数量、分页大小、有效上限、当前偏移、下一页偏移;单位:条。末页 next_offset 为 null。 |
| data.meta.possibly_more | 本页是否已满。缺失数值保留 null,不补零。 |
返回结构示例
{"data": {"fields": ["ts_code", "name", "management", "custodian", "fund_type", "found_date", "due_date", "list_date", "issue_date", "delist_date", "issue_amount", "m_fee", "c_fee", "duration_year", "p_value", "min_amount", "exp_return", "benchmark", "status", "invest_type", "type", "trustee", "purc_startdate", "redm_startdate", "market"], "items": [], "meta": {"limit": 2, "next_offset": null, "offset": 0, "possibly_more": false, "returned_count": 0}}, "message": "", "success": true}
SDK:client.fund_basic(...);MCP 工具:fund_basic。参数错误返回 HTTP 400 和英文原因;服务暂不可用返回 HTTP 503,不伪装为空数据。调用频率、并发及错误处理统一见调用规则。