Tortoise/README.md

Tortoise Stock

轻量级 A 股投研回测系统。当前已提供 Python sidecar 的统一数据获取与 DuckDB 本地缓存接口，后续策略模块可直接基于该接口读取 K 线与行情快照。

Python sidecar

安装依赖：

pip install -e .[test]

启动服务：

uvicorn sidecar.api:app --host 127.0.0.1 --port 8765

常用接口：

• GET /health：健康检查。
• GET /kline/{symbol}?period=day&limit=800&refresh=false：获取 K 线，底层使用 mootdx 并写入 DuckDB。
• GET /snapshot/{symbol}?refresh=false：获取实时快照，优先腾讯财经，失败后回退 mootdx，并写入 DuckDB TTL 缓存。

默认 DuckDB 文件为 data/tortoise.duckdb，可通过 TORTOISE_DUCKDB_PATH 修改。

策略1：中证 A500 收盘价图

运行：

python -m strategy.a500_close_chart --refresh

默认输出：strategy/output/a500_close.svg。

策略2：中证 A500 与沪深 300 双轴收盘价图

运行：

python -m strategy.a500_hs300_close_chart --refresh

默认输出：strategy/output/a500_hs300_close.svg。