跳转至

运行回测

本篇导览

项目 说明
目标 掌握三种回测接口
前置 编写策略

1. 运行回测

1.1 run_strategy(推荐)

一站式运行回测并生成所有报告。

result = run_strategy(
    initialize,
    start_date='2024-01-01',
    end_date='2024-12-31',
    starting_cash=100000,
    benchmark='000300.XSHG',
    securities=['601390', '600519'],
    report_dir='reports',
)

1.2 run_backtest(精细控制)

只运行回测,不生成报告。

result = run_backtest(
    initialize,
    start_date='2024-01-01',
    end_date='2024-12-31',
    starting_cash=100000,
)

1.3 run_portfolio_backtest(组合回测)

面向多股票组合的高层接口。

from eqlib import (
    StrategyConfig, run_portfolio_backtest,
    attribute_history, order_value, order_target,
)

config = StrategyConfig(
    starting_cash=200000,
    securities=["601390", "600519", "000858"],
    benchmark="000300.XSHG",
    position_pct=0.33,
    start_date="2024-01-01",
    end_date="2024-12-31",
    report_suffix="momentum_v1",
)

def my_strategy(context):
    for sec in context.universe:
        hist = attribute_history(sec, 25, "1d", ["close"])
        if hist.empty:
            continue
        ma20 = hist["close"].tail(20).mean()
        price = hist["close"].iloc[-1]
        if price > ma20 * 1.02:
            order_value(sec, context.portfolio.available_cash)
        elif price < ma20 * 0.98 and context.portfolio.positions.get(sec):
            order_target(sec, 0)

result = run_portfolio_backtest(config, my_strategy, report_dir="reports")

1.4 返回值结构

三个接口都返回一个字典 result,常用键:

键 内容
context 回测上下文;result['context'].portfolio 取最终持仓与资金
trade_log 逐笔成交记录列表(日期、代码、方向、价格、数量、费用)
recorded_values 按日期排序的每日记录(总资产、record() 自定义字段)
benchmark 基准代码
benchmark_values 基准每日收盘价序列(用于 alpha/beta 计算与画图)

组合回测额外带一个 config 键(回传入参)。

final_value = result['context'].portfolio.total_value
for trade in result['trade_log'][:5]:
    print(trade['date'], trade['security'], trade['type'], trade['price'])

1.5 基准对比

通过 benchmark 参数设置基准(默认 000300.XSHG 沪深300)。结果会自动计算 alpha、beta 和 information ratio。


完整参数说明见 回测引擎 API 参考。