基金数据服务

基估宝 API 文档

为 APK / Web 提供统一的基金搜索、基金详情、历史净值、走势补充数据与估值排行能力。

基础域名 https://api.jigubao.com

协议 加密传输 / JSON

缓存调试头 X-Jigubao-Cache

通用返回格式

成功返回

{
  "success": true,
  "data": {}
}

失败返回

{
  "success": false,
  "data": null,
  "error": {
    "code": "UPSTREAM_ERROR",
    "message": "基金数据暂时不可用"
  }
}

字段	类型	说明
`success`	boolean	是否成功。`true` 表示业务成功，`false` 表示失败。
`data`	object \| array \| null	业务数据主体。成功时通常为对象或数组，失败时通常为 `null`。
`error`	object \| null	错误信息对象。成功时通常为 `null`。
`error.code`	string	错误码，例如 `UPSTREAM_ERROR`、`INTERNAL_ERROR`。
`error.message`	string	可读错误描述。

调试响应头

排行接口会返回缓存命中状态，方便判断是否重复抓取上游：

X-Jigubao-Cache: miss：本次未命中缓存，接口刚抓取上游数据。
X-Jigubao-Cache: hit：本次命中缓存，接口直接返回缓存结果。

健康检查

读取

/healthz

用于确认服务是否在线。

https://api.jigubao.com/healthz

搜索基金

读取

/api/funds/search?keyword=000001

根据基金代码或名称关键字搜索基金。

https://api.jigubao.com/api/funds/search?keyword=000001

字段	类型	说明
`code`	string	6 位基金代码，例如 `000001`。
`name`	string	基金名称，例如 `华夏成长混合`。

基金详情

读取

/api/funds/{code}/detail

返回基金详情、估值、净值、真实涨幅与阶段涨幅聚合数据。

https://api.jigubao.com/api/funds/000001/detail

字段	类型	说明
`code`	string	基金代码，统一为 6 位字符串。
`name`	string	基金名称。
`dwjz`	number \| null	单位净值。通常来自最新历史净值。
`gsz`	number \| null	估算净值。
`gszzl`	number \| null	估算涨幅，单位 %。
`gztime`	string \| null	估值时间，通常为 `HH:mm`。
`jzrq`	string \| null	净值日期，通常为 `YYYY-MM-DD`。
`zzl`	number \| null	真实涨幅，单位 %。
`lastNav`	number \| null	上一日或上一条历史净值。
`week1`	number \| null	近一周涨幅。
`month1`	number \| null	近一月涨幅。
`year1`	number \| null	近一年涨幅。
`raw`	object	原始聚合补充信息。

字段	类型	说明
`content`	string	历史净值原始 HTML 片段解析结果。
`date`	string \| null	最新净值日期。
`nav`	number \| null	最新净值。
`growth`	number \| null	最新涨跌幅，单位 %。
`previous_nav`	number \| null	上一条净值。

走势补充数据

读取

/api/funds/{code}/pingzhongdata

返回东财走势补充数据解析结果，用于阶段涨幅和走势图补充。

https://api.jigubao.com/api/funds/000001/pingzhongdata

字段	类型	说明
`Data_netWorthTrend`	array	单位净值走势数组，常用于计算近一周涨幅。
`syl_1y`	string \| number \| null	近一月收益率字段，当前详情接口映射为 `month1`。
`syl_1n`	string \| number \| null	近一年收益率字段，当前详情接口映射为 `year1`。

基金估值排行

提交

/api/rankings/valuation

返回基金估值排行数据，当前用于 APK / Web 排行页。

请求体

{
  "type": 1,
  "sort": 3,
  "order": "desc",
  "page": 1,
  "pageSize": 10
}

参数	类型	说明
`type`	number	榜单分类，当前客户端默认固定为 `1`。
`sort`	number	排序字段，`3` 常用于估值涨幅，`1` 常用于净值。
`order`	string	排序方向，`desc` 或 `asc`。
`page`	number	页码，当前服务最多处理前 10 页。
`pageSize`	number	每页条数。

字段	类型	说明
`code`	string	基金代码，统一后的标准字段。
`name`	string	基金名称，统一后的标准字段。
`dwjz`	number \| null	单位净值。
`gsz`	number \| null	估算净值。
`gszzl`	number \| null	估算涨幅。
`gztime`	string \| null	估值时间。
`jzrq`	string \| null	净值日期或排行日期兜底值。
`zzl`	number \| null	真实涨幅。

原始字段	类型	说明
`bzdm`	string	基金代码，上游原始字段。
`jjjc`	string	基金简称，上游原始字段。
`JJGSID`	string	基金公司 ID。
`FType`	string	基金类型描述，例如 `混合型-偏股`。
`fundtype`	string	基金类型编码。
`PLevel`	number	上游内部评级或分级字段。
`Discount`	number	费率折扣值。
`Rate`	string	申购费率描述，例如 `0.15%`。
`feature`	string	上游特征标签组合字符串。
`sgzt`	string	申购状态，例如 `开放申购`。
`shzt`	string \| null	赎回状态。
`isbuy`	string	是否可买，通常 `1` 表示可买。
`gspc`	string \| null	估值偏差或相关字段，上游原始返回，当前未做标准业务映射。
`gbdwjz`	string \| number \| null	上游原始净值补充字段。
`jzzzl`	string \| number \| null	原始真实涨幅字段，常用于映射 `zzl`。
`gxrq`	string \| null	更新时间日期。
`gzrq`	string \| null	估值日期。
`gszzlcolor`	string \| null	上游用于前端显示的估值涨幅颜色标记。
`jzzzlcolor`	string \| null	上游用于前端显示的真实涨幅颜色标记。

浏览器调试

fetch("https://api.jigubao.com/api/rankings/valuation", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    type: 1,
    sort: 3,
    order: "desc",
    page: 1,
    pageSize: 10
  })
}).then(async (res) => {
  console.log("status:", res.status);
  console.log("x-jigubao-cache:", res.headers.get("x-jigubao-cache"));
  console.log(await res.json());
});

缓存策略

接口	策略
排行	交易时段 2 分钟缓存；收盘后与周末缓存到下一个交易日 09:30
搜索	10 分钟
详情	60 秒
最新历史净值	5 分钟
走势补充数据	30 分钟

错误码

错误码	说明
`UPSTREAM_ERROR`	上游基金数据源返回异常或无法解析
`INTERNAL_ERROR`	服务内部异常

字段设计说明

为了兼容多个上游来源，当前 API 对字段分成两层：

标准字段：例如 code、name、dwjz、gsz、gszzl、gztime、jzrq、zzl，推荐客户端优先依赖。
原始字段：例如 bzdm、jjjc、JJGSID、Rate、Discount、jzzzl、gxrq、gzrq，主要用于调试、回溯或临时扩展。

快速入口

读取 健康检查

/healthz

用于确认服务是否在线。

读取 搜索基金

/api/funds/search?keyword=000001

根据基金代码或名称关键字搜索基金。

读取 基金详情

/api/funds/000001/detail

返回基金详情、估值、净值与阶段涨幅聚合数据。

读取 最新历史净值

/api/funds/000001/history/latest

返回最近两条历史净值计算结果。

读取 走势补充数据

/api/funds/000001/pingzhongdata

返回东财走势补充数据解析结果。