---
title: "量化回测（策略回测 · 单标的实时 / 组合预计算）"
method: GET
path: "/v1/backtest"
tags: ["pro"]
---

# 量化回测（策略回测 · 单标的实时 / 组合预计算）

`GET /v1/backtest`

## Request

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

⭐ **量化回测**：对给定标的或组合，按内置策略跑历史回测，返回收益/风险指标（可选净值曲线）。

**两种模式**（用 `mode` 区分）：
- `mode=single`（默认）：**单标的择时**回测，**实时计算**（毫秒级）。传 `code` + `strategy`。
- `mode=portfolio`：**组合回测**（多标的选股），传 `strategy`。
  ⚠️ 结果按**预置区间**返回（现有 4 个：全周期 / 近 4 年 / 近 2 年 / 前半段）；**省略 `start`/`end` = 全周期**（起点最早、终点最新）。传其他区间会返回此刻可用的区间清单（见响应 `available_ranges`）。
  ⭐ 可选 `weighting` 指定**权重方案**：`equal`（默认·等权）/ `inv_vol`（**波动率倒数** —— 波动小的多配、大的少配，属 **Unlimited** 档能力）。

**`strategy` 取值**（单标的 20 条）：`buy_hold` `low_vol` `dca` `vol_target` `ma_stop` `ma_cross` `grid` `mom20` `turtle` `rev5` `breakout` `atr_stop` `macd` `rsi` `boll` `kdj` `wr` `obv` `cci` `sar`
（组合 9 条）：`buy_hold_equal` `lowvol20` `mom20` `mom20_ex_st` `rev5` `ma_cross` `volume_breakout` `smallcap` `largecap`

⚠️ **成本已计入**：佣金（万三，最低 5 元）/ 印花税（卖出 0.05%）/ 过户费（沪市）/ 滑点（千一）。
⚠️ **已计入约束**：涨跌停（不可成交则顺延）/ 停牌（缺行情即不成交）。
⚠️ **ST 按当前名单**近似（历史逐日 ST 状态无公开源）——ST 股占全市场约 3.6%，影响局限在触及板限时。
⚠️ **未计入**：冲击成本、容量约束。

⚠️ 属**付费层**（需 API Key）—— 门槛 **`standard`（¥29.9）及以上**。
⚠️ **日额度**：`standard` 30 次 / 日 · `pro` 300 次 / 日 · `unlimited` 1000 次 / 日。
⚠️ **历史回测结果不代表未来表现**，仅供研究，不构成投资建议。

## Query parameters

- `mode` string: single=单标的实时 / portfolio=组合（查预计算）
- `strategy` string: 内置策略名（见描述）
- `code` string: mode=single 时必填：A股代码 sh600519
- `start` string: 回测起始日 YYYY-MM-DD（mode=portfolio 时须为预置区间之一）
- `end` string: 回测结束日 YYYY-MM-DD（省略=最新）
- `initial_cash` number: 初始资金（默认 100 万）
- `weighting` string: mode=portfolio 权重方案：equal=等权 / inv_vol=波动率倒数（不限量版）
- `include_equity` boolean: 是否返回净值曲线

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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