deltafq 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of deltafq might be problematic. Click here for more details.
- deltafq/__init__.py +30 -31
- deltafq/backtest/__init__.py +17 -7
- deltafq/backtest/engine.py +99 -52
- deltafq/backtest/metrics.py +113 -0
- deltafq/backtest/performance.py +81 -0
- deltafq/backtest/reporter.py +91 -0
- deltafq/core/__init__.py +19 -0
- deltafq/core/base.py +37 -0
- deltafq/core/config.py +63 -0
- deltafq/core/exceptions.py +35 -0
- deltafq/core/logger.py +46 -0
- deltafq/data/__init__.py +17 -7
- deltafq/data/cleaner.py +41 -0
- deltafq/data/fetcher.py +52 -0
- deltafq/data/storage.py +56 -0
- deltafq/data/validator.py +52 -0
- deltafq/indicators/__init__.py +17 -8
- deltafq/indicators/momentum.py +56 -23
- deltafq/indicators/technical.py +59 -0
- deltafq/indicators/trend.py +129 -61
- deltafq/indicators/volatility.py +67 -27
- deltafq/live/__init__.py +17 -0
- deltafq/live/connection.py +235 -0
- deltafq/live/data_feed.py +159 -0
- deltafq/live/monitoring.py +192 -0
- deltafq/live/risk_control.py +193 -0
- deltafq/strategy/__init__.py +17 -6
- deltafq/strategy/base_strategy.py +53 -0
- deltafq/strategy/portfolio.py +82 -0
- deltafq/strategy/risk_manager.py +64 -0
- deltafq/strategy/signal_generator.py +52 -0
- deltafq/trading/__init__.py +19 -0
- deltafq/trading/broker.py +119 -0
- deltafq/trading/execution.py +176 -0
- deltafq/trading/order_manager.py +111 -0
- deltafq/trading/position_manager.py +157 -0
- deltafq/trading/simulator.py +150 -0
- deltafq-0.1.2.dist-info/METADATA +110 -0
- deltafq-0.1.2.dist-info/RECORD +43 -0
- deltafq-0.1.2.dist-info/entry_points.txt +2 -0
- {deltafq-0.1.0.dist-info → deltafq-0.1.2.dist-info}/licenses/LICENSE +21 -22
- deltafq/backtest/result.py +0 -45
- deltafq/data/base.py +0 -30
- deltafq/data/loader.py +0 -63
- deltafq/optimization/__init__.py +0 -6
- deltafq/optimization/grid_search.py +0 -41
- deltafq/performance/__init__.py +0 -6
- deltafq/performance/metrics.py +0 -37
- deltafq/risk/__init__.py +0 -7
- deltafq/risk/metrics.py +0 -33
- deltafq/risk/position.py +0 -39
- deltafq/strategy/base.py +0 -44
- deltafq/trade/__init__.py +0 -6
- deltafq/trade/broker.py +0 -40
- deltafq/utils/__init__.py +0 -6
- deltafq/utils/time.py +0 -32
- deltafq-0.1.0.dist-info/METADATA +0 -195
- deltafq-0.1.0.dist-info/RECORD +0 -29
- {deltafq-0.1.0.dist-info → deltafq-0.1.2.dist-info}/WHEEL +0 -0
- {deltafq-0.1.0.dist-info → deltafq-0.1.2.dist-info}/top_level.txt +0 -0
deltafq/strategy/base.py
DELETED
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
"""策略基类"""
|
|
2
|
-
|
|
3
|
-
from abc import ABC, abstractmethod
|
|
4
|
-
from typing import Dict, Any
|
|
5
|
-
import pandas as pd
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
class Strategy(ABC):
|
|
9
|
-
"""策略抽象基类"""
|
|
10
|
-
|
|
11
|
-
def __init__(self):
|
|
12
|
-
self.position = 0 # 当前持仓
|
|
13
|
-
self.cash = 100000 # 初始资金
|
|
14
|
-
self.signals = [] # 信号记录
|
|
15
|
-
|
|
16
|
-
@abstractmethod
|
|
17
|
-
def on_bar(self, bar: pd.Series) -> None:
|
|
18
|
-
"""处理每根K线
|
|
19
|
-
|
|
20
|
-
Args:
|
|
21
|
-
bar: 包含OHLCV数据的Series
|
|
22
|
-
"""
|
|
23
|
-
pass
|
|
24
|
-
|
|
25
|
-
def buy(self, size: float = 1.0) -> None:
|
|
26
|
-
"""买入信号
|
|
27
|
-
|
|
28
|
-
Args:
|
|
29
|
-
size: 交易数量
|
|
30
|
-
"""
|
|
31
|
-
self.signals.append({'action': 'buy', 'size': size})
|
|
32
|
-
|
|
33
|
-
def sell(self, size: float = 1.0) -> None:
|
|
34
|
-
"""卖出信号
|
|
35
|
-
|
|
36
|
-
Args:
|
|
37
|
-
size: 交易数量
|
|
38
|
-
"""
|
|
39
|
-
self.signals.append({'action': 'sell', 'size': size})
|
|
40
|
-
|
|
41
|
-
def get_signals(self) -> list:
|
|
42
|
-
"""获取所有交易信号"""
|
|
43
|
-
return self.signals
|
|
44
|
-
|
deltafq/trade/__init__.py
DELETED
deltafq/trade/broker.py
DELETED
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
"""交易接口抽象"""
|
|
2
|
-
|
|
3
|
-
from abc import ABC, abstractmethod
|
|
4
|
-
from typing import Dict, Any, List
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
class Broker(ABC):
|
|
8
|
-
"""券商接口抽象基类"""
|
|
9
|
-
|
|
10
|
-
@abstractmethod
|
|
11
|
-
def submit_order(
|
|
12
|
-
self,
|
|
13
|
-
symbol: str,
|
|
14
|
-
action: str,
|
|
15
|
-
quantity: float,
|
|
16
|
-
order_type: str = "market"
|
|
17
|
-
) -> str:
|
|
18
|
-
"""提交订单
|
|
19
|
-
|
|
20
|
-
Args:
|
|
21
|
-
symbol: 证券代码
|
|
22
|
-
action: 动作 'buy' or 'sell'
|
|
23
|
-
quantity: 数量
|
|
24
|
-
order_type: 订单类型
|
|
25
|
-
|
|
26
|
-
Returns:
|
|
27
|
-
订单ID
|
|
28
|
-
"""
|
|
29
|
-
pass
|
|
30
|
-
|
|
31
|
-
@abstractmethod
|
|
32
|
-
def get_position(self) -> List[Dict[str, Any]]:
|
|
33
|
-
"""获取持仓信息"""
|
|
34
|
-
pass
|
|
35
|
-
|
|
36
|
-
@abstractmethod
|
|
37
|
-
def get_account(self) -> Dict[str, Any]:
|
|
38
|
-
"""获取账户信息"""
|
|
39
|
-
pass
|
|
40
|
-
|
deltafq/utils/__init__.py
DELETED
deltafq/utils/time.py
DELETED
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
"""时间相关工具函数"""
|
|
2
|
-
|
|
3
|
-
import pandas as pd
|
|
4
|
-
from datetime import datetime
|
|
5
|
-
from typing import List
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
def is_trading_day(date: datetime) -> bool:
|
|
9
|
-
"""判断是否为交易日
|
|
10
|
-
|
|
11
|
-
Args:
|
|
12
|
-
date: 日期
|
|
13
|
-
|
|
14
|
-
Returns:
|
|
15
|
-
是否为交易日
|
|
16
|
-
"""
|
|
17
|
-
return date.weekday() < 5
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
def get_trading_dates(start: str, end: str) -> List[datetime]:
|
|
21
|
-
"""获取交易日列表
|
|
22
|
-
|
|
23
|
-
Args:
|
|
24
|
-
start: 开始日期
|
|
25
|
-
end: 结束日期
|
|
26
|
-
|
|
27
|
-
Returns:
|
|
28
|
-
交易日列表
|
|
29
|
-
"""
|
|
30
|
-
dates = pd.date_range(start=start, end=end, freq='B')
|
|
31
|
-
return dates.tolist()
|
|
32
|
-
|
deltafq-0.1.0.dist-info/METADATA
DELETED
|
@@ -1,195 +0,0 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: deltafq
|
|
3
|
-
Version: 0.1.0
|
|
4
|
-
Summary: 专业的Python量化交易库
|
|
5
|
-
Author-email: DeltaFQ Team <your.email@example.com>
|
|
6
|
-
License: MIT
|
|
7
|
-
Project-URL: Homepage, https://github.com/Delta-F/deltafq
|
|
8
|
-
Project-URL: Documentation, https://deltafq.readthedocs.io
|
|
9
|
-
Project-URL: Repository, https://github.com/Delta-F/deltafq
|
|
10
|
-
Project-URL: PyPI, https://pypi.org/project/deltafq/
|
|
11
|
-
Project-URL: Bug Tracker, https://github.com/Delta-F/deltafq/issues
|
|
12
|
-
Keywords: quantitative,trading,finance,backtest,strategy
|
|
13
|
-
Classifier: Development Status :: 3 - Alpha
|
|
14
|
-
Classifier: Intended Audience :: Financial and Insurance Industry
|
|
15
|
-
Classifier: Intended Audience :: Developers
|
|
16
|
-
Classifier: License :: OSI Approved :: MIT License
|
|
17
|
-
Classifier: Programming Language :: Python :: 3
|
|
18
|
-
Classifier: Programming Language :: Python :: 3.8
|
|
19
|
-
Classifier: Programming Language :: Python :: 3.9
|
|
20
|
-
Classifier: Programming Language :: Python :: 3.10
|
|
21
|
-
Classifier: Programming Language :: Python :: 3.11
|
|
22
|
-
Classifier: Topic :: Office/Business :: Financial :: Investment
|
|
23
|
-
Requires-Python: >=3.8
|
|
24
|
-
Description-Content-Type: text/markdown
|
|
25
|
-
License-File: LICENSE
|
|
26
|
-
Requires-Dist: pandas>=1.3.0
|
|
27
|
-
Requires-Dist: numpy>=1.21.0
|
|
28
|
-
Provides-Extra: dev
|
|
29
|
-
Requires-Dist: pytest>=7.0.0; extra == "dev"
|
|
30
|
-
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
|
|
31
|
-
Requires-Dist: black>=22.0.0; extra == "dev"
|
|
32
|
-
Requires-Dist: flake8>=5.0.0; extra == "dev"
|
|
33
|
-
Requires-Dist: mypy>=0.990; extra == "dev"
|
|
34
|
-
Provides-Extra: plot
|
|
35
|
-
Requires-Dist: matplotlib>=3.5.0; extra == "plot"
|
|
36
|
-
Provides-Extra: all
|
|
37
|
-
Requires-Dist: matplotlib>=3.5.0; extra == "all"
|
|
38
|
-
Dynamic: license-file
|
|
39
|
-
|
|
40
|
-
# DeltaFQ
|
|
41
|
-
|
|
42
|
-
[](https://badge.fury.io/py/deltafq)
|
|
43
|
-
[](https://www.python.org/downloads/)
|
|
44
|
-
[](https://opensource.org/licenses/MIT)
|
|
45
|
-
|
|
46
|
-
专业的Python量化交易库,为量化策略开发者和研究人员提供从数据获取到策略回测的完整工具链。
|
|
47
|
-
|
|
48
|
-
## 特性
|
|
49
|
-
|
|
50
|
-
- 📊 **多源数据支持** - 统一的数据接口,支持多种数据源
|
|
51
|
-
- 📈 **丰富的技术指标** - 内置常用技术指标,支持自定义扩展
|
|
52
|
-
- 🎯 **灵活的策略框架** - 简洁的API,快速构建交易策略
|
|
53
|
-
- ⚡ **高效的回测引擎** - 向量化计算,快速验证策略效果
|
|
54
|
-
- 📉 **全面的风险管理** - 仓位管理、风险控制、绩效分析
|
|
55
|
-
- 🔧 **参数优化工具** - 多种优化算法,寻找最佳参数
|
|
56
|
-
- 📱 **实盘交易接口** - 统一的交易接口,无缝切换模拟与实盘
|
|
57
|
-
|
|
58
|
-
## 安装
|
|
59
|
-
|
|
60
|
-
```bash
|
|
61
|
-
pip install deltafq
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
或者安装开发版本:
|
|
65
|
-
|
|
66
|
-
```bash
|
|
67
|
-
git clone https://github.com/Delta-F/deltafq.git
|
|
68
|
-
cd deltafq
|
|
69
|
-
pip install -e .
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
## 快速开始
|
|
73
|
-
|
|
74
|
-
### 获取数据
|
|
75
|
-
|
|
76
|
-
```python
|
|
77
|
-
import deltafq as dfq
|
|
78
|
-
|
|
79
|
-
# 获取股票数据
|
|
80
|
-
data = dfq.data.get_stock_daily('000001.SZ', start='2020-01-01', end='2023-12-31')
|
|
81
|
-
print(data.head())
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
### 计算技术指标
|
|
85
|
-
|
|
86
|
-
```python
|
|
87
|
-
# 计算移动平均线
|
|
88
|
-
data['ma5'] = dfq.indicators.SMA(data['close'], 5)
|
|
89
|
-
data['ma20'] = dfq.indicators.SMA(data['close'], 20)
|
|
90
|
-
|
|
91
|
-
# 计算MACD
|
|
92
|
-
macd = dfq.indicators.MACD(data['close'])
|
|
93
|
-
data = data.join(macd)
|
|
94
|
-
```
|
|
95
|
-
|
|
96
|
-
### 构建交易策略
|
|
97
|
-
|
|
98
|
-
```python
|
|
99
|
-
class MAStrategy(dfq.strategy.Strategy):
|
|
100
|
-
"""双均线策略"""
|
|
101
|
-
|
|
102
|
-
def on_bar(self, bar):
|
|
103
|
-
if bar.ma5 > bar.ma20:
|
|
104
|
-
self.buy()
|
|
105
|
-
elif bar.ma5 < bar.ma20:
|
|
106
|
-
self.sell()
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
### 运行回测
|
|
110
|
-
|
|
111
|
-
```python
|
|
112
|
-
# 创建回测引擎
|
|
113
|
-
engine = dfq.backtest.BacktestEngine(
|
|
114
|
-
initial_cash=100000,
|
|
115
|
-
commission=0.0003
|
|
116
|
-
)
|
|
117
|
-
|
|
118
|
-
# 运行回测
|
|
119
|
-
result = engine.run(data, MAStrategy())
|
|
120
|
-
|
|
121
|
-
# 查看结果
|
|
122
|
-
print(result.summary())
|
|
123
|
-
result.plot()
|
|
124
|
-
```
|
|
125
|
-
|
|
126
|
-
## 模块说明
|
|
127
|
-
|
|
128
|
-
- **data** - 数据获取和管理
|
|
129
|
-
- **indicators** - 技术指标计算
|
|
130
|
-
- **strategy** - 策略开发框架
|
|
131
|
-
- **backtest** - 回测引擎
|
|
132
|
-
- **risk** - 风险管理
|
|
133
|
-
- **performance** - 绩效分析
|
|
134
|
-
- **optimization** - 参数优化
|
|
135
|
-
- **trade** - 实盘交易接口
|
|
136
|
-
- **utils** - 工具函数
|
|
137
|
-
|
|
138
|
-
## 示例
|
|
139
|
-
|
|
140
|
-
查看 `examples/` 目录获取更多示例代码:
|
|
141
|
-
|
|
142
|
-
- `ma_strategy.py` - 双均线策略
|
|
143
|
-
- `macd_strategy.py` - MACD策略
|
|
144
|
-
- `optimization_example.py` - 参数优化示例
|
|
145
|
-
|
|
146
|
-
## 文档
|
|
147
|
-
|
|
148
|
-
- **使用指南**: [docs/GUIDE.md](docs/GUIDE.md)
|
|
149
|
-
- **API参考**: [docs/API.md](docs/API.md)
|
|
150
|
-
- **开发指南**: [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md)
|
|
151
|
-
- **更新日志**: [docs/CHANGELOG.md](docs/CHANGELOG.md)
|
|
152
|
-
|
|
153
|
-
## 依赖
|
|
154
|
-
|
|
155
|
-
- Python >= 3.8
|
|
156
|
-
- pandas >= 1.3.0
|
|
157
|
-
- numpy >= 1.21.0
|
|
158
|
-
|
|
159
|
-
## 开发
|
|
160
|
-
|
|
161
|
-
```bash
|
|
162
|
-
# 克隆仓库
|
|
163
|
-
git clone https://github.com/Delta-F/deltafq.git
|
|
164
|
-
cd deltafq
|
|
165
|
-
|
|
166
|
-
# 安装开发依赖
|
|
167
|
-
pip install -e ".[dev]"
|
|
168
|
-
|
|
169
|
-
# 运行测试
|
|
170
|
-
pytest
|
|
171
|
-
|
|
172
|
-
# 代码格式化
|
|
173
|
-
black deltafq/
|
|
174
|
-
|
|
175
|
-
# 类型检查
|
|
176
|
-
mypy deltafq/
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
## 许可证
|
|
180
|
-
|
|
181
|
-
本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
|
|
182
|
-
|
|
183
|
-
## 贡献
|
|
184
|
-
|
|
185
|
-
欢迎提交 Issue 和 Pull Request!
|
|
186
|
-
|
|
187
|
-
## 联系方式
|
|
188
|
-
|
|
189
|
-
- 项目主页:[https://github.com/Delta-F/deltafq](https://github.com/Delta-F/deltafq)
|
|
190
|
-
- PyPI 主页:[https://pypi.org/project/deltafq/](https://pypi.org/project/deltafq/)
|
|
191
|
-
- 问题反馈:[https://github.com/Delta-F/deltafq/issues](https://github.com/Delta-F/deltafq/issues)
|
|
192
|
-
|
|
193
|
-
---
|
|
194
|
-
|
|
195
|
-
⚠️ **风险提示**:量化交易存在风险,本库仅供学习研究使用,不构成投资建议。实盘交易需谨慎,风险自担。
|
deltafq-0.1.0.dist-info/RECORD
DELETED
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
deltafq/__init__.py,sha256=CR_ufA8vkfg6NeolNBnRTLLQhk7GTGWMKfQnDQG6zsM,640
|
|
2
|
-
deltafq/backtest/__init__.py,sha256=nH_lnnpx-XPs2FY8j4DdeptX5Rwumbgn9l82kyiu5Ds,184
|
|
3
|
-
deltafq/backtest/engine.py,sha256=YefCepHM9_Y4EJi5y4eDhjwLILu5iaj1Z7soaXjZLy4,1248
|
|
4
|
-
deltafq/backtest/result.py,sha256=2DS1b9c5iJb8BCeQt9p7p_hrqc805P8mWoqyu-pa3Zs,1164
|
|
5
|
-
deltafq/data/__init__.py,sha256=LCjI7BY2SE4JY_AyWoFd66Pb-9uPRvmuZYlsF6lZAF8,215
|
|
6
|
-
deltafq/data/base.py,sha256=nwwKlLD70jq7bv51F9umWygPKbN-vP_7GpxUdyI0K6g,610
|
|
7
|
-
deltafq/data/loader.py,sha256=wi6aYVUZ4c7u0LV-lHIKX40NnZ7twYga60oq0Pdex3s,1614
|
|
8
|
-
deltafq/indicators/__init__.py,sha256=kNg84vs20ShQYYxKL6j5p5aJWjpdyS2pivRPuHzpRA0,233
|
|
9
|
-
deltafq/indicators/momentum.py,sha256=CRGGjrs-kGpuuV7srTGy2jr9hvvnYF2AIlzOn9grBXI,502
|
|
10
|
-
deltafq/indicators/trend.py,sha256=kaC9tAQq-fR5bfVdHAMgiMgscfcKQCwTz2yG2ZN_N2c,1287
|
|
11
|
-
deltafq/indicators/volatility.py,sha256=jhCHrvdJa_nvPbjEFa1ktH-gDY3wT7Z2vPjQ7DRtjk0,626
|
|
12
|
-
deltafq/optimization/__init__.py,sha256=5uPJiOunFcRWupI2Nn37Jq2VShFASmM_UI7nZx93cCc,133
|
|
13
|
-
deltafq/optimization/grid_search.py,sha256=G_8xVBOr2Vac2RaI9B-WI3mYyzl0zVHuvNrmEdFXUiE,1100
|
|
14
|
-
deltafq/performance/__init__.py,sha256=JDxi_hTmbPSGafvtYjLM5r_r2pVz2L_njM4bUOpvpfw,186
|
|
15
|
-
deltafq/performance/metrics.py,sha256=r0akhbkVVN6g_vuJPb9V7k2-zx7i-tAPmLf7ejRT72c,843
|
|
16
|
-
deltafq/risk/__init__.py,sha256=ckuV7Mg5ijGCUDH9fbEbgxWyaLdcpSG92JYXwh_qUUg,229
|
|
17
|
-
deltafq/risk/metrics.py,sha256=cAUi3bWL4KDOOizgDfe8uKuOEuTWIhXEhG0mkuRFeo0,732
|
|
18
|
-
deltafq/risk/position.py,sha256=h11b7obMpriavPVXzgTiPXDAsjsXAkNy6SVEyoSItqA,911
|
|
19
|
-
deltafq/strategy/__init__.py,sha256=MtT73CleKjhlUPoauAqD2oVFi2sgNdfIB2ZFQhXNkVU,100
|
|
20
|
-
deltafq/strategy/base.py,sha256=chzi59RQUy1hIGZ8r4QPYcdpeVrC1VqtXPyTnGVFkAE,1066
|
|
21
|
-
deltafq/trade/__init__.py,sha256=9MLD7LlybjP0uATMbAqDPYkuwFIP1PPE9PG5WduUZBs,101
|
|
22
|
-
deltafq/trade/broker.py,sha256=IMW3e38mv8XkYF279tqQxKUIjcZ79N82cb52uFhEAWY,875
|
|
23
|
-
deltafq/utils/__init__.py,sha256=AMUJnZSlvojkgOWXROglzXXwqslHrp25YH_9GBbOA0s,149
|
|
24
|
-
deltafq/utils/time.py,sha256=0XGMR8xxX39HS-h7xg0gN6pTuOK-SOlRsWeQq9XLW5Y,641
|
|
25
|
-
deltafq-0.1.0.dist-info/licenses/LICENSE,sha256=5_jN6PqRGcdXKxxg6PCYHU7A2u29fcTdA-8laOCdsZU,1092
|
|
26
|
-
deltafq-0.1.0.dist-info/METADATA,sha256=l-1eLC18TbCd1ay_i06gSfvO0sMqDPDAx5aQ5ep45GY,5495
|
|
27
|
-
deltafq-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
28
|
-
deltafq-0.1.0.dist-info/top_level.txt,sha256=j1Q3ce7BEqdXVZd-mlHiJBDHq3iJGiKRKEXPW8xHLHo,8
|
|
29
|
-
deltafq-0.1.0.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|