26 lines
771 B
Markdown
26 lines
771 B
Markdown
# 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` 修改。
|