# DeltaFQ

<div align="center">

[中文](README.md) | [English](README_EN.md)

![Version](https://img.shields.io/badge/version-0.6.1-7C3AED.svg)
![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-D97706.svg)
![Python](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-2563EB.svg)
![Build](https://img.shields.io/badge/build-manual-lightgrey.svg)
![License](https://img.shields.io/badge/license-MIT-10B981.svg)

Python 开源量化框架： 覆盖“研究、回测、交易”全生命周期，构建从零到实盘的工业级量化闭环工作流。

<p align="center">
  <img src="assets/signals.png" width="48%" alt="策略信号图" />
  <img src="assets/overview.png" width="48%" alt="回测结果面板" />
</p>

</div>


## 专属教程

慕课网 - 程序员AI量化理财体系课：https://class.imooc.com/sale/aiqwm


## 安装

```bash
pip install deltafq
```

## 核心功能

- 📥 获取历史数据 - 默认集成免费数据源，支持全球多市场
- 🧪 常用指标计算 - 快速计算 MACD、布林带等，内置兼容 TA-Lib
- 🧠 极速策略开发 - 几行代码即可通过信号生成器与模板完成开发
- 📉 高性能回测 - 极速跑测，支持多策略对比与深度绩效分析
- ⚡ 实时行情分发 - 基于事件驱动架构，实现秒级分发与 Tick 处理
- 🤖 实盘/仿真交易 - 插件化设计，支持从模拟账户到实盘柜台无缝切换
- 📊 交互式可视化 - 自动生成 Plotly 交互式图表，精准洞察细节
- 📝 系统日志管理 - 统一管理运行状态，支持多级记录与文件存储


## 接口集成

DeltaFQ 通过插件化适配器（Adapters）灵活接入各类外部接口：

- ✅ **yfinance** - 已接入，支持多市场历史与实时行情获取
- ✅ **PaperTrade** - 已接入，支持多市场本地模拟交易与持仓管理
- 🛠️ **qmt** - 计划中，支持 A 股实盘行情快照与柜台订单执行
- 🛠️ **Tushare** - 计划中，提供更丰富的 A 股金融基础数据

## 快速上手

```python
import deltafq as dfq

# 1. 定义策略逻辑
class MyStrategy(dfq.strategy.BaseStrategy):
    def generate_signals(self, data):
        bands = dfq.indicators.TechnicalIndicators().boll(data["Close"])
        return dfq.strategy.SignalGenerator().boll_signals(data["Close"], bands)

# 2. 极简回测与展示
engine = dfq.backtest.BacktestEngine()
engine.set_parameters("GOOGL", "2025-07-26", "2026-01-26")
engine.load_data()
engine.add_strategy(MyStrategy(name="BOLL"))
engine.run_backtest()
engine.show_report()
engine.show_chart(use_plotly=False)
```


## 应用示例
DeltaFStation 基于 deltafq 的开源量化交易云平台，集成数据服务、策略管理与交易接入，支持模拟与实盘。项目地址：https://github.com/Delta-F/deltafstation/

<table align="center">
  <tr>
    <td><img src="assets/deltafstation_1.png" height="260" alt="DeltaFStation Architecture" /></td>
    <td><img src="assets/deltafstation_2.png" height="260" alt="DeltaFStation Backtest Engine" /></td>
  </tr>
</table>


## 项目架构

```
deltafq/
├── data        # 数据获取、清洗、存储接口（支持股票、基金数据）
├── indicators  # 技术指标与因子计算
├── strategy    # 信号生成器与策略基类
├── backtest    # 回测执行、绩效度量、报告
├── live        # 事件引擎、网关抽象与路由
├── adapters    # 行情/交易适配器（可插拔）
├── trader      # 交易执行与订单/持仓管理
└── charts      # 信号、绩效图表组件
```

<table align="center">
  <tr>
    <td><img src="assets/deltafq_arch.png" height="400" alt="项目架构" /></td>
    <td><img src="assets/deltafq_wf.png" height="400" alt="工作流" /></td>
  </tr>
</table>


## 参与贡献

- 反馈与改进：欢迎通过 [Issue](https://github.com/Delta-F/deltafq/issues) 或 PR 提交改进。
- 微信公众号：关注 `DeltaFQ开源量化`，获取版本更新、重要策略与量化资料。

<p align="center">
  <img src="assets/wechat_qr.png" width="150" alt="微信公众号" />
</p>


## 许可证

MIT License，详见 [LICENSE](LICENSE)。
