API REFERENCE

公募基金列表

查询场内、场外公募基金资料,默认场外,可用 market 区分。

数据范围
场内和场外公募基金,market=E/O区分,默认场外
包含内容
基金名称、管理人、托管人、类型、成立与上市日期、费率和状态等资料
时间覆盖
非逐日历史快照;每只基金含成立日 found_date、上市日 list_date 等日期,例如 000001.OF 成立于 2001-12-18
数据频率
基本资料

公募基金列表

POSThttps://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。
marketE 场内、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,不伪装为空数据。调用频率、并发及错误处理统一见调用规则。