跳到主要内容

基金在线回测

通用约定
  • Base URL：https://fuyao.aicubes.cn。
  • 必需请求头：X-api-key；认证、权限和业务错误通过响应 code 表达。
  • 本页接口返回统一 ApiResponse 信封，包含 code、message、data 与 request_id。
  • 回测基金使用含市场后缀的完整 thscode，例如 000001.OF；裸代码和上游市场代码不是公开入参。
  • 回测条件以 URL 编码的 JSON 字符串传递；具体指标、操作符和阈值以“回测可用指标”返回结果为准。
  • 回测日期使用 yyyy-MM-dd 字符串；数值和动态曲线键值保持上游语义，不进行单位换算。
  • 示例参数已通过真实上游调用验证；返回数据会随上游更新，响应示例仅展示部分交易和曲线点。

基金在线回测​

GET /api/fund/backtest/result

MCP Tool：get_fund_backtest_result

请求参数​

参数类型必需默认值说明
thscodestring是—含市场后缀的完整基金代码，例如 000001.OF。
buy_conditionsstring是—买入条件 JSON 字符串，必须是对象或数组。
sell_conditionsstring是—卖出条件 JSON 字符串，必须是对象或数组。
buy_frequency_typestring是—买入频率，具体值由上游判定。
max_buy_timesnumber是—最大买入次数。
per_buy_amountnumber是—每次买入金额。

请求示例​

curl 'https://fuyao.aicubes.cn/api/fund/backtest/result?thscode=000001.OF&buy_conditions=%7B%22indicator_code%22%3A%22rsi_pct%22%2C%22operator%22%3A%22%3E%22%2C%22value%22%3A0.5%7D&sell_conditions=%7B%22indicator_code%22%3A%22rsi_pct%22%2C%22operator%22%3A%22%3C%22%2C%22value%22%3A0.3%7D&buy_frequency_type=WEEKLY&max_buy_times=5&per_buy_amount=100' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "5fbc0c2db60a4e298a0d48c4de049642",
  "data": {
    "start_date": "2023-09-08",
    "end_date": "2026-09-08",
    "metrics": {
      "strategy_return": 0.422452870829321,
      "fund_return": 0.4099340336826627,
      "excess_return": 0.0125188371466583,
      "win_rate": 0,
      "max_drawdown": 0.2700061087331572
    },
    "trade_count": 726,
    "trades": [
      {
        "trade_date": "2023-09-11",
        "type": "BUY",
        "price": 5.8066057624,
        "amount": 100,
        "shares": 17.22176501934028,
        "profit": null
      }
    ],
    "curve_points": [
      {
        "2023-09-08": 0
      }
    ]
  }
}

返回字段​

data 字段：

字段类型说明
start_datestring回测开始日期。
end_datestring回测结束日期。
metricsobject回测指标。
trade_countnumber交易次数。
tradesarray交易明细。
curve_pointsJSON收益曲线点集合，兼容数组或对象结构。

data.metrics 字段：

字段类型说明
strategy_returnnumber策略收益。
fund_returnnumber基金收益。
excess_returnnumber超额收益。
win_ratenumber胜率。
max_drawdownnumber最大回撤。

data.trades[] 字段：

字段类型说明
trade_datestring交易日期。
typestring交易类型。
pricenumber交易价格。
amountnumber交易金额。
sharesnumber交易份额。
profitnumber | null交易收益。

基金回测可用指标​

GET /api/fund/backtest/indicators

MCP Tool：get_fund_backtest_indicators

请求参数​

参数位置类型必需说明默认值
----无业务参数。-

请求示例​

curl 'https://fuyao.aicubes.cn/api/fund/backtest/indicators' \
  -H 'X-api-key: <your-api-key>'

响应示例​

{
  "code": 0,
  "message": "success",
  "request_id": "af1c4ed643f744218950885dd58bd2c9",
  "data": [
    {
      "id": 1,
      "indicator_name": "净值波动",
      "indicator_code": "rsi_pct",
      "type": 0,
      "value_kind": 0,
      "support_operation": ">,<",
      "unit": null,
      "description": null,
      "state_rules": null,
      "create_time": "2026-05-27T16:57:32",
      "update_time": "2026-05-27T16:57:32"
    }
  ]
}

返回字段​

data[] 字段：

字段类型说明
idnumber指标标识。
indicator_namestring指标名称。
indicator_codestring指标编码。
typenumber上游定义的指标类型。
value_kindnumber上游定义的指标值类型。
support_operationstring支持的条件操作符。
unitstring | null指标单位。
descriptionstring | null指标说明。
state_rulesstring | null状态规则。
create_timestring上游记录创建时间，使用 ISO 本地日期时间。
update_timestring上游记录更新时间，使用 ISO 本地日期时间。