---
title: "Agent Backtest"
method: POST
path: "/api/v2/agent/backtest"
tags: ["backtest-agent"]
---

# Agent Backtest

`POST /api/v2/agent/backtest`

## Request

- Base URL: `https://api.ticktest.cn` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ticktest.cn/api/v2/agent/backtest`
- Auth: none declared

**AI Agent 统一回测入口**

接收策略自然语言描述，自动解析为可执行策略，完成回测后返回六大必返指标。

六大指标:
- **sharpe_ratio** — 年化夏普比率
- **max_drawdown** — 最大回撤 (%)
- **win_rate** — 胜率 (%)
- **annualized_return** — 年化收益率 (%)
- **total_return** — 总收益率 (%)
- **profit_curve** — 累计收益曲线（逐日）

**支付流程**（生产环境, TICKTEST_REQUIRE_PAYMENT=true）:
1. 调用 `/api/v2/agent/backtest` → 返回 HTTP 402 + Payment-Needed 头
2. AI Agent 展示支付界面 → 用户授权支付
3. Agent 重新请求并携带 Payment-Proof 头 → 验证 → 执行回测 → 履约确认

## Request body

- BacktestAgentRequest: AI Agent 统一回测请求
  - `symbol` string, required: 股票代码，如 000001 或 sz000001
  - `strategy` string, required: 策略自然语言描述，如 'MA5上穿MA20买入，MA5下穿MA20卖出'
  - `start_date` string: 回测开始日期 YYYY-MM-DD，默认6个月前
  - `end_date` string: 回测结束日期 YYYY-MM-DD，默认今天
  - `market` string: 市场: sh/sz/bj（symbol 格式为纯6位时使用）
  - `initial_capital` number: 初始资金
  - `strategy_name` string, nullable: 策略名称（可选，不传则自动生成）

## Response `200`

Successful Response

- BacktestAgentResponse: AI Agent 统一回测响应 — 六大必返指标
  - `status` string, required: success / error
  - `symbol` string
  - `strategy_name` string
  - `strategy_code` string, nullable: 解析后的策略代码（.acl 格式）
  - `period` string
  - `sharpe_ratio` number
  - `max_drawdown` number
  - `win_rate` number
  - `annualized_return` number
  - `total_return` number
  - `profit_curve` number[]: 累计收益曲线（逐日）
  - `trade_count` integer
  - `total_pnl` number
  - `avg_pnl` number
  - `payment_required` boolean
  - `payment_form` string, nullable: 支付宝支付 HTML 表单（需付费时返回）
  - `message` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ticktest/apis/ticktest-api.md) · [All operations](https://skmtc.dev/ticktest/apis/ticktest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ticktest/apis/ticktest-api/revisions/3e6d69d0eb1e?raw)