# FastTrade **Repository Path**: stylesmile/FastTrade ## Basic Information - **Project Name**: FastTrade - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

FastTrade logo

FastTrade

📈 从数据到实盘的开源量化交易工作台

一套策略代码,贯通 数据下载 / 回测 / 模拟盘 / 实盘,同时覆盖 Web3、A 股、期货 三个市场。

Python Node.js PostgreSQL Redis License

简体中文 | [English](./README.en.md)
## 📌 FastTrade 是什么 FastTrade 是一个前后端分离的量化交易平台:后端基于 **FastAPI + SQLAlchemy 2(异步)+ APScheduler + Redis**,前端基于 **Vue 3 + TypeScript + Vite + Element Plus**。 它把量化研究中最常用的四件事做成了一条完整链路: ```text 行情数据 → 策略开发 → 回测验证 → 模拟盘跟踪 → 实盘执行 (币安/CSV) (自动发现) (本地引擎) (实时行情) (币安/柜台) ``` 核心设计是 **策略只写一次**:同一份策略同时用于回测、模拟盘和实盘,只切换执行器;三个市场共用同一套策略目录与交易接口,只是数据源、数据表和柜台不同。管理台(用户、角色、菜单、日志、任务、存储等)作为平台底座提供,不是本项目的重点。 > 完整操作手册见 [`docs/README.md`](./docs/README.md);管理后台操作文档见 [`docs/admin/README.md`](./docs/admin/README.md)。 ## 🎯 量化核心能力 | 能力 | 说明 | | --- | --- | | 🪙 **币安数据下载** | 官方 REST、公开镜像、历史归档 ZIP 三种来源;支持现货与 U 本位合约,长历史按整月/整日归档拉取,自动去重合并、补齐近端 | | 📥 **本地 CSV 导入** | 标准 OHLCV(`date,open,high,low,close,volume`),路径限制在允许目录内,导入后登记为可复用数据集 | | 📊 **数据图表** | ECharts 绘制 K 线 + 成交量 + OHLCV 明细表,默认返回最近 2000 根,避免大文件拖垮前端 | | 🧠 **策略自动发现** | 扫描 `user_data/strategies/*.py`,自动识别事件模式与信号模式 | | ⚡ **事件驱动回测** | 当前 K 线收盘产生信号、下一根开盘成交;输出收益、年化、最大回撤、胜率、成交流水与净值曲线 | | 📝 **模拟盘(paper)** | 实时行情 + 虚拟资金,本地即时撮合,账本持久化 | | 🔴 **实盘(live)** | 复用同一策略;默认 `dry_run` 不下真实单,密钥 Fernet 加密落库且接口永不回传明文 | | 🖥️ **CLI + REST + 页面** | 下载、导入、回测、实例启停、手动 tick 均可用命令行、API 或页面完成 | | 🏦 **三市场统一** | Web3 / A 股 / 期货页面结构一致,共用策略与执行引擎,柜台可插拔(XTP / CTP 默认模拟) | ### 三个市场 | 市场 | 路由前缀 | 数据目录 | 数据表前缀 | 行情 / 柜台 | | --- | --- | --- | --- | --- | | **web3-量化** | `/quant` | `user_data/data/binance` | `quant_web3_*` | 币安 REST / 镜像 / 历史归档 | | **量化-A股** | `/quant-astock` | `user_data/data/astock` | `quant_astock_*` | 本地 CSV / XTP(默认模拟) | | **量化-期货** | `/quant-futures` | `user_data/data/futures` | `quant_futures_*` | 本地 CSV / CTP(默认模拟) | > 三个市场各有「数据、数据图表、回测、模拟盘、实盘」页面;A 股 / 期货当前柜台为模拟适配层,接入真实 SDK 时上层策略与页面无需改动。 ## 🔁 一套策略,三种模式 ```text 同一份策略代码(user_data/strategies/*.py) │ api.buy / sell / sellshort / buycover / close_all │ ┌───────────────────┼───────────────────┐ ▼ ▼ ▼ 回测执行器 模拟盘执行器 实盘执行器 下一根开盘价撮合 最新价虚拟撮合 币安下单 + 记账 ``` | 环节 | 回测 | 模拟盘 paper | 实盘 live | | --- | --- | --- | --- | | 行情 | 本地 CSV | 实时滚动 K 线 | 实时滚动 K 线 | | 撮合 | 下一根开盘价 | 最新价即时撮合 | 最新价即时撮合 + 币安下单 | | 资金 | 初始资金 | 虚拟资金 | 真实 / 模拟(看 `dry_run`) | | 做空 | 支持 | 支持 | 币安现货真实下单不支持 | | 驱动 | 一次性跑完 | 常驻轮询 | 常驻轮询 | ### 策略示例 ```python from quant_api import Strategy class SmaCrossStrategy(Strategy): """5/20 均线交叉:金叉开多,死叉平多。""" name = "SMA均线交叉" timeframe = "1h" startup_candle_count = 20 def on_bar(self, api, candles, index): fast = api.sma(5) slow = api.sma(20) if index < self.startup_candle_count: return if fast[index - 1] <= slow[index - 1] and fast[index] > slow[index]: api.buy(ratio=0.95, reason="golden_cross") elif fast[index - 1] >= slow[index - 1] and fast[index] < slow[index]: api.sell(reason="death_cross") ``` 策略还可以用信号模式实现 `populate_entry_trend()` / `populate_exit_trend()`(参考 freqtrade 的信号列写法)。可用接口包括 `buy`、`sell`、`sellshort`、`buycover`、`close_all`、`sma`、`ema`、`rsi`、`log` 以及 `cash` / `equity` / `position` 等状态属性。 ## 🚀 快速开始 ### 环境要求 | 依赖 | 版本 | | --- | --- | | Python | ≥ 3.12(推荐 `uv` 管理依赖) | | Node.js | ≥ 20.19(推荐 pnpm 9) | | PostgreSQL | 14+(默认数据库) | | Redis | 7.x(会话 / 缓存 / 限流) | ### 启动后端 ```bash cp backend/env/.env.example backend/env/.env.dev # 填写 DATABASE_* / REDIS_* / SECRET_KEY cd backend uv sync uv run main.py run --env=dev ``` 首次启动会自动执行迁移、建表并写入基础数据。接口文档:。 ### 启动前端 ```bash cd front-web pnpm install pnpm dev ``` 浏览器打开 ,使用种子账号 `admin / 123456` 登录(其他种子账号:`super`、`user`,首次登录后请修改密码)。若侧栏没有量化菜单,执行一次幂等补菜单命令: ```bash cd backend && uv run python main.py quant init-menu --env=dev ``` 然后重新登录刷新菜单。 ## 🧭 量化操作流程 ### 1. 准备数据 - **币安数据**:进入「量化 → 下载」,选择交易对、周期、现货/合约、时间范围与来源(`api` / `mirror` / `archive`)。 - **本地 CSV**:按 `date,open,high,low,close,volume` 表头准备文件,放到 `user_data/data/` 下后导入。 - **A 股 / 期货**:在对应市场的「数据」页导入 CSV 即可,tick 时会优先使用同代码已导入的数据集。 ### 2. 开发策略 把策略文件放入 `user_data/strategies/`,在页面选择策略时即可看到自动发现结果。修改后无需重启后端。 ### 3. 回测验证 在「回测」页选择数据集与策略,设置初始资金、手续费率、滑点后执行。结果包含: - 期末净值、总收益率、年化收益率、最大回撤、胜率; - 每笔成交(方向、数量、价格、手续费、盈亏、原因); - 净值曲线与策略日志。 ### 4. 模拟盘 / 实盘 在「模拟盘」或「实盘」页创建实例,可启动常驻轮询、手动运行一次 tick、查看账户与成交流水。 > **实盘安全默认值**:`dry_run=True`,不连接交易所、不下真实单。只有显式关闭 dry-run 且配置币安 API Key / Secret 后才会真实下单。Key 建议只授予现货交易权限,**不要开启提现**;现货真实模式不支持做空。 ## 💻 命令行速查 所有命令在 `backend/` 目录执行,`quant` 为主命令,`mingling` 为兼容别名。 ```bash # 列出自动发现的策略 uv run python main.py quant strategies --env=dev # 下载币安数据:官方 REST / 公开镜像 / 历史归档 uv run python main.py quant download -s BTC/USDT -i 1h --days 30 --env=dev uv run python main.py quant download -s BTC/USDT -i 4h --market futures --source archive \ --start 2024-01-01 --end 2024-12-31 --env=dev # 导入本地 CSV uv run python main.py quant import user_data/data/my_data.csv \ --symbol BTC/USDT --interval 1h --env=dev # 执行回测 uv run python main.py quant backtest --dataset 1 --strategy SmaCrossStrategy \ --cash 10000 --fee 0.001 --slippage 0.0005 --env=dev # 创建模拟盘 / 实盘实例并驱动 uv run python main.py quant live-create --name BTC-1h-SMA \ --strategy SmaCrossStrategy --symbol BTC/USDT --interval 1h \ --mode paper --cash 10000 --env=dev uv run python main.py quant live-tick 1 --env=dev uv run python main.py quant live-tick 1 \ --data-file user_data/data/binance/BTCUSDT_1h.csv --env=dev ``` `--data-file` 支持离线用本地 CSV 驱动一次 tick,适合网络受限或回归验证。 ## 🔌 API 与权限 量化接口统一挂在 `/api/v1` 下,使用项目统一响应信封: | 前缀 | 说明 | | --- | --- | | `/api/v1/quant/data` | 数据集、下载、导入、K 线 | | `/api/v1/quant/strategies` | 策略列表 | | `/api/v1/quant/backtest` | 回测执行与记录 | | `/api/v1/quant/live` | 实时策略实例、启停、tick、成交流水 | | `/api/v1/quant-astock` | A 股数据 / 回测 / 实时策略 | | `/api/v1/quant-futures` | 期货数据 / 回测 / 实时策略 | 权限码与路由前缀对应:`module_quant:*`、`module_quant_astock:*`、`module_quant_futures:*`,动作包括 `data:query/download/import`、`strategy:query`、`backtest:run/query`、`live:create/query/update/start/run/delete`。超级管理员默认放行,普通角色需在「系统管理 → 角色管理」授权。 ## 📦 工程结构 ```text FastTrade/ ├─ backend/ # FastAPI 后端 │ ├─ app/modules/quant/ # web3 量化:数据、策略、回测、执行、实时实例 │ ├─ app/modules/quant_market/ # A股 + 期货通用模块(按 market key 参数化) │ ├─ app/modules/system/ # 用户、角色、菜单、部门、字典、日志等平台底座 │ ├─ app/modules/task/ # 定时任务与存储工作流 │ ├─ app/modules/monitor/ # 服务 / 缓存 / 在线用户监控 │ ├─ app/modules/ai/ # AI 对话 │ ├─ app/modules/generator/ # 代码生成器 │ ├─ app/modules/ops/ # SSH 终端、数据库控制台 │ ├─ app/api/v1/routers.py # 唯一路由注册入口 │ └─ app/alembic/versions/ # 数据库迁移 ├─ front-web/ # Vue 3 管理台 │ └─ src/views/ │ ├─ module_quant/ # web3 页面(下载、图表、回测、模拟盘、实盘) │ ├─ module_quant_astock/ # A 股页面 │ ├─ module_quant_futures/ # 期货页面 │ └─ module_quant_market/ # A 股 / 期货共享工作区组件 ├─ user_data/ │ ├─ data/ # 行情 CSV(binance / astock / futures) │ └─ strategies/ # 三市场共用策略目录 ├─ docs/admin/ # 管理后台操作与开发文档 ├─ docs/quant/ # 量化操作与开发文档 └─ AGENTS.md # AI Agent 与协作规范 ``` 量化相关表共 12 张(每个市场 4 张):`*_dataset`、`*_backtest`、`*_live_strategy`、`*_trade_record`。 ## 🛠️ 技术栈 | 层 | 技术 | | --- | --- | | 后端 | Python 3.12+ · FastAPI · Pydantic v2 · SQLAlchemy 2(异步)· Alembic | | 存储 | PostgreSQL · Redis · SQLite(测试) | | 前端 | Vue 3 · TypeScript · Vite · Element Plus · Pinia · Tailwind CSS 4 · ECharts | | 调度 / 任务 | APScheduler · asyncio 常驻轮询 | | 外部集成 | 币安 REST / 历史归档 · XTP / CTP 适配层 · SFTP / S3 / OSS / COS / OBS | | 测试 | pytest(后端)· Vitest(前端) | ## 🧱 平台底座(次要) 管理台提供量化之外的通用能力,开箱即用但不属于本项目重点: | 模块 | 能力 | | --- | --- | | 系统管理 | 用户、角色、菜单、部门、岗位、字典、参数、公告、工单、版本 | | 监控 | 在线用户、服务器、缓存、健康检查 | | 日志 | 操作日志审计 | | 任务 | 定时任务、可视化存储工作流 | | 存储 | 本地 / SFTP / S3 / OSS / COS / OBS | | 开发工具 | 代码生成器、SSH 终端、数据库控制台、接口文档 | ## 🖥️ 界面 管理台基于 FastTrade 品牌主题,量化页面位于侧栏「量化 / 量化-A股 / 量化-期货」目录: ![管理台仪表盘](./front-web/public/dashboard.png) ## 🧪 测试 ```bash # 后端(默认 sqlite + mock Redis,无需外部服务) cd backend uv run pytest -q uv run pytest tests/test_quant_engine.py -q # 前端 cd front-web pnpm test pnpm type-check ``` 需要真实 PostgreSQL / Redis 的集成用例默认跳过,使用 `TEST_DB_TYPE=postgres RUN_INTEGRATION=1` 显式开启。 ## 📚 文档 - 管理后台总览与目录:[`docs/admin/README.md`](./docs/admin/README.md) - [登录与个性化](./docs/admin/01-登录与个性化.md) - [系统管理](./docs/admin/02-系统管理.md) - [日志与监控](./docs/admin/03-日志与监控.md) - [定时任务与存储](./docs/admin/04-定时任务与存储.md) - [运维与开发](./docs/admin/05-运维与开发.md) - [AI助手](./docs/admin/06-AI助手.md) - [权限与安全](./docs/admin/07-权限与安全.md) - 量化总览与目录:[`docs/README.md`](./docs/README.md) - [数据下载与导入](./docs/quant/01-数据下载与导入.md) - [策略开发](./docs/quant/02-策略开发.md) - [回测操作](./docs/quant/03-回测操作.md) - [命令行](./docs/quant/04-命令行.md) - [API 参考](./docs/quant/05-API参考.md) - [模拟盘与实盘](./docs/quant/06-模拟盘与实盘.md) - [统一策略接口](./docs/quant/07-统一策略接口.md) - [三市场与数据图表](./docs/quant/08-三市场与数据图表.md) ## ⚠️ 风险与边界 - 本项目仅供研究与技术学习,**不构成投资建议**;实盘盈亏由使用者自行承担。 - 回测存在过拟合、滑点、流动性等现实偏差,历史表现不代表未来收益。 - 实盘默认 `dry_run`;真实下单前请用小额资金与模拟盘充分验证。 - 币安现货真实模式不支持做空;期货细节(资金费率、保证金、部分成交、订单簿深度)尚未实现。 - A 股 / 期货的 XTP / CTP 当前为模拟柜台,未接入真实 SDK。 - 密钥请放在 `backend/env/.env.*` 或加密字段中,**不要提交到仓库**。 ## 🤝 参与贡献 欢迎提交 Issue / PR。提交前请阅读 [`AGENTS.md`](./AGENTS.md),并确保后端 `uv run ruff check`、相关 `pytest` 与前端 `pnpm type-check`、`pnpm test` 通过。 ## 🙏 鸣谢 - 量化思路参考 [freqtrade](https://www.freqtrade.io/) 的数据归档与信号列设计; - 管理台底座源自 [FastapiAdmin](https://gitee.com/fastapiadmin/FastapiAdmin); - 后端:[FastAPI](https://fastapi.tiangolo.com/) · [Pydantic](https://docs.pydantic.dev/) · [SQLAlchemy](https://www.sqlalchemy.org/) · [APScheduler](https://github.com/agronholm/apscheduler) - 前端:[Vue 3](https://cn.vuejs.org/) · [TypeScript](https://www.typescriptlang.org/) · [Vite](https://vitejs.dev/) · [Element Plus](https://element-plus.org/) · [ECharts](https://echarts.apache.org/) ## 📄 License [MIT](./LICENSE)