基金净值与业绩

通用约定

Base URL：https://fuyao.aicubes.cn。
必需请求头：X-api-key；认证与权限错误通过业务 code 表达。
本页接口返回统一 ApiResponse 信封；时间戳均为毫秒级 Unix 时间戳，时区按 Asia/Shanghai。
thscode 是基金唯一标识，必须保留市场后缀。收益率、占比和回撤字段为百分数原值。

基金净值

GET /api/fund/performance/nav

MCP Tool：get_fund_performance_nav

请求参数

参数	类型	必需	默认值	说明
`thscode`	string	是	—	完整基金 thscode，必须保留市场后缀。
`range`	string	否	最新一条	`week` / `month` / `tmonth` / `hyear` / `year` / `twoyear` / `tyear` / `fyear`。
`nav_type`	string	否	`unit,adj`	`unit`（单位净值）/ `adj`（复权净值）/ `unit,adj`（同时返回）。

不传 range 时最多返回最新一个净值日期；传入后按 nav_date 升序返回区间序列。 unit_nav 为单位净值，adj_nav 为复权净值，复权净值不等同于累计净值。

请求示例

curl 'https://fuyao.aicubes.cn/api/fund/performance/nav?thscode=510300.SH&range=year&nav_type=unit' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "97634b0fbf4746afaa32e8a71adbd636",
  "data": {
    "timestamp": 1784131200000,
    "item": [
      {
        "nav_date": 1752595200000,
        "unit_nav": 4.0713
      },
      {
        "nav_date": 1752681600000,
        "unit_nav": 4.1015
      }
    ]
  }
}

返回字段

data.item[] 字段：

字段	类型	说明
`nav_date`	long	净值日期，毫秒级 Unix 时间戳。
`unit_nav`	number	单位净值；未通过 `nav_type` 请求时不输出。
`adj_nav`	number	复权净值；未通过 `nav_type` 请求时不输出，不等同于累计净值。

基金区间收益

GET /api/fund/performance/returns

MCP Tool：get_fund_performance_returns

请求参数

参数	类型	必需	默认值	说明
`thscode`	string	是	—	完整基金 thscode，必须保留市场后缀。

请求示例

curl 'https://fuyao.aicubes.cn/api/fund/performance/returns?thscode=510300.SH' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "61cb2a8b9340483aaf00e36748f77918",
  "data": {
    "timestamp": 0,
    "item": [
      {
        "return_month": -3.33,
        "return_tmonth": 0.03,
        "return_hyear": 0.19,
        "return_year": 19.66,
        "return_tyear": 28.69,
        "return_fyear": 1.77,
        "return_nowyear": 2.49,
        "return_now": 121.58
      }
    ]
  }
}

返回字段

data.item[] 字段：

字段	类型	说明
`return_month`	number	近一月收益率，百分数原值。
`return_week`	number	近一周收益率，百分数原值。
`return_tmonth`	number	近三月收益率，百分数原值。
`return_hyear`	number	近半年收益率，百分数原值。
`return_year`	number	近一年收益率，百分数原值。
`return_twoyear`	number	近两年收益率，百分数原值。
`return_tyear`	number	近三年收益率，百分数原值。
`return_fyear`	number	近五年收益率，百分数原值。
`return_nowyear`	number	今年以来收益率，百分数原值。
`return_now`	number	成立以来收益率，百分数原值。
`peer_average_week`	number	近一周同类平均收益率，百分数原值。
`peer_average_month`	number	近一月同类平均收益率，百分数原值。
`peer_average_tmonth`	number	近三月同类平均收益率，百分数原值。
`peer_average_hyear`	number	近半年同类平均收益率，百分数原值。
`peer_average_year`	number	近一年同类平均收益率，百分数原值。
`peer_average_twoyear`	number	近两年同类平均收益率，百分数原值。
`peer_average_tyear`	number	近三年同类平均收益率，百分数原值。
`peer_average_fyear`	number	近五年同类平均收益率，百分数原值。
`rank_week`	integer	近一周同类排名。
`rank_month`	integer	近一月同类排名。
`rank_tmonth`	integer	近三月同类排名。
`rank_hyear`	integer	近半年同类排名。
`rank_year`	integer	近一年同类排名。
`rank_twoyear`	integer	近两年同类排名。
`rank_tyear`	integer	近三年同类排名。
`rank_fyear`	integer	近五年同类排名。
`rank_total_week`	integer	近一周参与同类排名的基金总数。
`rank_total_month`	integer	近一月参与同类排名的基金总数。
`rank_total_tmonth`	integer	近三月参与同类排名的基金总数。
`rank_total_hyear`	integer	近半年参与同类排名的基金总数。
`rank_total_year`	integer	近一年参与同类排名的基金总数。
`rank_total_twoyear`	integer	近两年参与同类排名的基金总数。
`rank_total_tyear`	integer	近三年参与同类排名的基金总数。
`rank_total_fyear`	integer	近五年参与同类排名的基金总数。

基金历史业绩指标

GET /api/fund/performance/indicators-historical

MCP Tool：get_fund_performance_indicators_historical

请求参数

参数	类型	必需	默认值	说明
`thscode`	string	是	—	完整基金 thscode。
`start`	long	是	—	起始时间，毫秒 Unix 时间戳。
`end`	long	是	—	结束时间，毫秒 Unix 时间戳。

参数必填

start 和 end 均为必填参数。此前未传这两个参数的客户端需要补充起止时间后再调用。

请求示例

curl 'https://fuyao.aicubes.cn/api/fund/performance/indicators-historical?thscode=510300.SH&start=1735689600000&end=1767225599000' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "046f8a0b787c44a7b995c568096fa16c",
  "data": {
    "timestamp": 1767225599000,
    "item": [
      {
        "date_ms": 1767139200000,
        "rsi_pct": 53.8,
        "donchian_channel": 0.42,
        "track_index_pe_ttm_five_year_percentile": 61.3
      }
    ]
  }
}

返回字段

data 仅包含 timestamp 和 item，其中 timestamp 保留明确的上游数据时间。指标周期固定为 DAY_1，不作为顶层字段返回；响应也不返回顶层 thscode 或 interval。

data.item[] 字段：

字段	类型	说明
`date_ms`	long	指标日期，毫秒 Unix 时间戳。
`rsi_pct`	number	净值波动（RSI）指标值。
`donchian_channel`	number	趋势强弱（唐奇安通道）指标值。
`track_index_pe_ttm_five_year_percentile`	number	估值百分位（跟踪指数 PE TTM 五年分位）。

基金最大回撤

GET /api/fund/performance/drawdowns

MCP Tool：get_fund_performance_drawdowns

请求参数

参数	类型	必需	默认值	说明
`thscode`	string	是	—	完整基金 thscode。

请求示例

curl 'https://fuyao.aicubes.cn/api/fund/performance/drawdowns?thscode=510300.SH' \
  -H 'X-api-key: <your-api-key>'

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "7c7fdfe771fc4c61bbab8410a250b61e",
  "data": {
    "timestamp": 1786690800000,
    "item": [
      {
        "thscode": "510300.SH",
        "ticker": "510300",
        "week": -1.2,
        "month": -3.6,
        "tmonth": -6.8,
        "hyear": -9.1,
        "year": -12.5,
        "twoyear": -18.4,
        "tyear": -21.7,
        "fyear": -28.9,
        "nowyear": -7.3,
        "now": -31.2
      }
    ]
  }
}

返回字段

data.timestamp 为接口响应时间戳；data.item[] 字段：

字段	类型	说明
`thscode`	string	完整同花顺代码。
`ticker`	string	纯代码，用于展示。
`week`	number	近一周最大回撤。
`month`	number	近一月最大回撤。
`tmonth`	number	近三月最大回撤。
`hyear`	number	近半年最大回撤。
`year`	number	近一年最大回撤。
`twoyear`	number	近两年最大回撤。
`tyear`	number	近三年最大回撤。
`fyear`	number	近五年最大回撤。
`nowyear`	number	今年以来最大回撤。
`now`	number	成立以来最大回撤。

通用参数与错误码参见基金 API 总览。

基金净值​

请求参数​

请求示例​

响应示例​

返回字段​

基金区间收益​

请求参数​

请求示例​

响应示例​

返回字段​

基金历史业绩指标​

请求参数​

请求示例​

响应示例​

返回字段​

基金最大回撤​

请求参数​

请求示例​

响应示例​

返回字段​

基金净值

请求参数

请求示例

响应示例

返回字段

基金区间收益

请求参数

请求示例

响应示例

返回字段

基金历史业绩指标

请求参数

请求示例

响应示例

返回字段

基金最大回撤

请求参数

请求示例

响应示例

返回字段