# Tortoise Stock

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

## Python sidecar

安装依赖：

```bash
pip install -e .[test]
```

启动服务：

```bash
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` 修改。