刚搓了一个量化回测工具，开源给需要的朋友，如果能够帮助到大家，欢迎点点关注，感谢支持！！！

交易想法靠谱吗？别靠感觉了，先扔进历史 K 线跑一遍再说！！！

由于我是 Hermes 新手，之前验证交易策略只知道跑模拟盘测试，参加了BG的黑客松我才知道，还可以进行数据回测。

所以我开源了一个本地加密货币回测工具：石头量化回测实验室（Hermes Backtest Lab）

开源地址：https://github.com/stong123456/stone-backtest-lab…

它不需要 API Key，也不是交易所机器人，核心就干一件事：把你的交易想法，丢进真实历史数据里跑一遍，看看数据怎么说。

——————————————————

支持的核心能力如下： 1、OKX 现货 + USDT 永续合约回测

2、多币种组合账户回测（模拟真实多标的账户）

3、多空双向（可只做多 / 只做空 / 双向）

4、链上 Token 回测（GeckoTerminal 数据源）

5、完整成本建模（手续费 + 滑点）

6、动态仓位、杠杆、保证金、回撤熔断

7、内置常用因子（趋势、均值回归、ATR、ADX、RSI、EMA、布林、成交量 z-score 等）

8、报告导出，每次回测会生成三类文件： report.md：适合人看的回测报告 metrics.json：适合程序读取的指标 trades.csv：每一笔模拟交易明细

——————————————————

可以用 powershell 跑，或者直接丢给你的AI处理

新手最快上手（推荐）： python -m pip install -r requirements.txt python scripts/hermes_backtest_lab.py –preset demo

常用预设直接跑： –preset balanced / conservative / aggressive / spot / onchain-demo

想自定义跑 OKX 永续： python scripts/hermes_backtest_lab.py –symbols BTC,ETH,SOL,SUI –inst-type SWAP –days 180 –bar 1H

想跑现货（禁止做空）： –symbols BTC,ETH,SOL –inst-type SPOT –allow-short 0 –days 180

想跑链上 Token： –data-source geckoterminal –symbols base:token:0x… –days 30 –bar 1H

更多用法直接看仓库 README。

——————————————————

为什么我认为回测最有价值？ 它不是用来证明你能赚钱的，而是给你一个冷冰冰铁面无私的质检员：

你的策略怕不怕手续费和滑点？

是靠几笔大赚撑起来的吗？

胜率、盈亏比、最大回撤、交易频率是否合理？

换一组币、换一个周期，还能不能活？

连历史数据 + 成本这一关都过不了的策略，上实盘大概率是送钱。

所以这个工具适合三类人：

想验证自己交易想法的人

想系统研究不同币种、周期、参数的人

想做自动化交易，但不想一上来就拿真金白银试错的人

——————————————————

最后提醒：历史回测不代表未来收益，但没有回测，很多时候你连自己亏在哪里都不知道。

欢迎 Star 、直接 clone 跑起来试试，跑完欢迎提 Issue 或反馈建议！

stong123456/stone-backtest-lab

Source: https://github.com/stong123456/stone-backtest-lab

石头量化回测实验室

英文名：Hermes Backtest Lab。

一个不需要 API Key 的本地加密货币回测工具。

它使用 OKX 公开 K 线数据和 GeckoTerminal 公开 DEX 数据，支持现货、USDT 永续合约、多链链上 token、多币种组合账户回测、手续费/滑点建模、动态杠杆、动态保证金、止盈止损、时间退出、因子归因和报告导出。

这不是投资建议。历史回测不代表未来收益。请先用小样本和模拟盘验证。

功能

• 任意 OKX 现货或 USDT 永续合约符号回测
• 任意 GeckoTerminal 支持的链上 token 或 DEX pool 回测
• 单币种回测或多币种组合账户回测
• 支持多空双向、只做多、只做空
• 内置趋势跟踪和震荡均值回归逻辑
• 内置 ATR、ADX、RSI、EMA、布林带、成交量 z-score 等指标
• 支持手续费、滑点、最大持仓、账户回撤熔断
• 输出 report.md、metrics.json、trades.csv
• 不读取 .env、交易所账户、私钥、API Key 或 Telegram Token

安装

需要 Python 3.10+。

cd hermes-backtest-lab
python -m pip install -r requirements.txt

Windows 用户也可以直接运行：

.\run_setup.ps1

最快开始

python scripts/hermes_backtest_lab.py --preset demo

如果不知道该用什么命令，先看中文短菜单：

python scripts/hermes_backtest_lab.py

运行后会在 outputs/hermes_backtest_lab/<时间戳>/ 生成：

• report.md：适合人看的回测报告
• metrics.json：适合程序读取的指标
• trades.csv：每一笔模拟交易明细

常用预设

# 查看所有预设和中文解释
python scripts/hermes_backtest_lab.py --list-presets

# 只看配置，不联网、不回测
python scripts/hermes_backtest_lab.py --dry-run --preset balanced

# 30 天快速检查，适合确认环境是否正常
python scripts/hermes_backtest_lab.py --preset demo

# 180 天均衡组合回测
python scripts/hermes_backtest_lab.py --preset balanced

# 更保守，只跑主流币，降低组合暴露
python scripts/hermes_backtest_lab.py --preset conservative

# 更激进，加入更多高波动标的
python scripts/hermes_backtest_lab.py --preset aggressive

# 现货只做多
python scripts/hermes_backtest_lab.py --preset spot

# 链上 token 回测，自动选择流动性最高的池子
python scripts/hermes_backtest_lab.py --preset onchain-demo

# Base 链 WETH token
python scripts/hermes_backtest_lab.py --data-source geckoterminal --symbols base:token:0x4200000000000000000000000000000000000006 --days 30 --bar 1H

# 直接指定某个 DEX pool
python scripts/hermes_backtest_lab.py --data-source geckoterminal --symbols base:pool:0xPOOL_ADDRESS --days 30 --bar 1H

你可以覆盖预设里的任何参数：

python scripts/hermes_backtest_lab.py --preset balanced --symbols BTC,ETH,SOL --days 90 --max-leverage 8

也可以把币种放进 txt 文件，每行一个，方便普通用户维护：

python scripts/hermes_backtest_lab.py --preset balanced --symbols-file examples/symbols_okx_bluechip.txt

Windows 一键脚本：

.\run_demo.ps1
.\run_balanced.ps1
.\run_onchain_demo.ps1

自定义回测

# 任意 OKX USDT 永续
python scripts/hermes_backtest_lab.py --symbols BTC,ETH,SUI,LINK --inst-type SWAP --days 180 --bar 1H

# 直接传 OKX instId
python scripts/hermes_backtest_lab.py --symbols BTC-USDT-SWAP,ETH-USDT-SWAP --days 90 --bar 4H

# 现货回测
python scripts/hermes_backtest_lab.py --symbols BTC,ETH,SOL --inst-type SPOT --allow-short 0 --days 180

# 链上 token。格式为 chain:token:contract，脚本会自动选择流动性最高的池子。
python scripts/hermes_backtest_lab.py --data-source geckoterminal --symbols eth:token:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48,base:token:0x4200000000000000000000000000000000000006 --days 30 --bar 1H

# 链上池子。格式为 chain:pool:pool_address。
python scripts/hermes_backtest_lab.py --data-source geckoterminal --symbols solana:pool:POOL_ADDRESS --days 30 --bar 1H

# 多币种共享一个账户，不按币种拆分本金
python scripts/hermes_backtest_lab.py --symbols BTC,ETH,SOL,SUI,LINK --inst-type SWAP --portfolio-mode 1 --starting-balance 100000 --min-margin 1000 --max-margin 3000

重要参数

查看更多命令

python scripts/hermes_backtest_lab.py
python scripts/hermes_backtest_lab.py --list-presets
python scripts/hermes_backtest_lab.py --examples
python scripts/hermes_backtest_lab.py --advanced-help

结果怎么看

不要只看胜率。优先看：

• 总收益和最大回撤是否匹配
• Profit Factor 是否大于 1
• 平均盈利是否明显大于平均亏损
• 交易次数是否足够，不要被小样本骗
• 盈利是否集中在少数几天或少数币
• 加入手续费和滑点后是否仍然有效

链上数据注意事项

• token 模式会自动选择 GeckoTerminal 返回的最高流动性池子，不一定等于你主观想交易的那个池子。
• pool 模式更精确，适合你已经知道目标池子地址的情况。
• 新币、小池子、低流动性池子的 K 线可能不完整，报告里会显示数据警告。
• 链上回测默认只是价格序列研究，没有模拟 MEV、gas、池子冲击成本、买卖税、黑名单、暂停交易、路由失败等真实链上执行风险。
• Meme 和小盘 token 的滑点建议手动调高，例如 --slippage-bps 30 或更高。

开源分享建议

如果你要发到 GitHub，建议只提交这些内容：

• README.md
• SKILL.md
• requirements.txt
• scripts/hermes_backtest_lab.py
• examples/commands.md
• .gitignore

不要提交：

• outputs/
• runtime-logs/
• cache/
• .env
• API Key、Telegram Token、交易所账户文件

石头 (@Stone141319): 现在很多人聊 AI Web3，都在盯着模型、应用、空投这些地方，但真到了一堆 AI Agent 上链执行任务、调用数据、协同交易、管理资产的时候，问题就会变得特别特别现实： 它的推理能不能被验证？

它调用的数据靠不靠谱？

它的记忆放在哪里？

它和其他 Agent 协作时，出了问题谁来审计？