Skip to content

Commit cdd49c4

Browse files
shinny-hongyanshinny-hongyan
authored
Update Version 3.8.1
1 parent 2b95ea6 commit cdd49c4

21 files changed

+245
-111
lines changed

‎PKG-INFO

Lines changed: 49 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Metadata-Version: 2.1
22
Name: tqsdk
3-
Version: 3.8.0
3+
Version: 3.8.1
44
Summary: TianQin SDK
55
Home-page: https://www.shinnytech.com/tqsdk
66
Author: TianQin
@@ -25,90 +25,87 @@ License-File: LICENSE
2525
<img src ="https://img.shields.io/github/license/shinnytech/tqsdk-python.svg?color=orange"/>
2626
</p>
2727

28-
TqSdk 天勤量化交易策略程序开发包
29-
====================================
30-
TqSdk 是一个由[信易科技](https://www.shinnytech.com)发起并贡献主要代码的开源 python 库.
31-
依托[快期多年积累成熟的交易及行情服务器体系](https://www.shinnytech.com/diff), TqSdk 支持用户使用极少的代码量构建各种类型的量化交易策略程序,
32-
并提供包含期货、期权、股票的 历史数据-实时数据-开发调试-策略回测-模拟交易-实盘交易-运行监控-风险管理 全套解决方案.
28+
# TqSdk 天勤量化交易策略程序开发包
3329

34-
``` {.sourceCode .python}
30+
TqSdk 是一个由[信易科技](https://www.shinnytech.com)发起并贡献主要代码的开源 Python 库。
31+
TqSdk 支持用户使用极少的代码量构建各种类型的量化交易策略程序，
32+
并提供包含期货、期权、股票的 历史数据-实时数据-开发调试-策略回测-模拟交易-实盘交易-运行监控-风险管理 全套解决方案。
33+
34+
## 快速开始
35+
36+
``` python
3537
from tqsdk import TqApi, TqAuth, TqAccount, TargetPosTask
3638

3739
api = TqApi(TqAccount("H海通期货", "4003242", "123456"), auth=TqAuth("快期账户", "账户密码")) # 创建 TqApi 实例, 指定交易账户
38-
q_1910 = api.get_quote("SHFE.rb1910") # 订阅近月合约行情
39-
t_1910 = TargetPosTask(api, "SHFE.rb1910") # 创建近月合约调仓工具
40-
q_2001 = api.get_quote("SHFE.rb2001") # 订阅远月合约行情
41-
t_2001 = TargetPosTask(api, "SHFE.rb2001") # 创建远月合约调仓工具
40+
q_2309 = api.get_quote("SHFE.rb2309") # 订阅近月合约行情
41+
t_2309 = TargetPosTask(api, "SHFE.rb2309") # 创建近月合约调仓工具
42+
q_2401 = api.get_quote("SHFE.rb2401") # 订阅远月合约行情
43+
t_2401 = TargetPosTask(api, "SHFE.rb2401") # 创建远月合约调仓工具
4244

4345
while True:
4446
api.wait_update() # 等待数据更新
45-
spread = q_1910["last_price"] - q_2001["last_price"] # 计算近月合约-远月合约价差
47+
spread = q_2309["last_price"] - q_2401["last_price"] # 计算近月合约-远月合约价差
4648
print("当前价差:", spread)
4749
if spread > 250:
4850
print("价差过高: 空近月，多远月")
49-
t_1910.set_target_volume(-1) # 要求把1910合约调整为空头1手
50-
t_2001.set_target_volume(1) # 要求把2001合约调整为多头1手
51+
t_2309.set_target_volume(-1) # 要求把2309合约调整为空头1手
52+
t_2401.set_target_volume(1) # 要求把2401合约调整为多头1手
5153
elif spread < 200:
52-
print("价差回复: 清空持仓") # 要求把 1910 和 2001合约都调整为不持仓
53-
t_1910.set_target_volume(0)
54-
t_2001.set_target_volume(0)
54+
print("价差回复: 清空持仓") # 要求把 2309 和 2401合约都调整为不持仓
55+
t_2309.set_target_volume(0)
56+
t_2401.set_target_volume(0)
5557
```
5658

57-
要快速了解如何使用TqSdk, 可以访问我们的 [十分钟快速入门指南](https://doc.shinnytech.com/tqsdk/latest/quickstart.html).
59+
要快速了解如何使用TqSdk，请访问我们的 [十分钟快速入门指南](https://doc.shinnytech.com/tqsdk/latest/quickstart.html)。
5860

61+
## 系统架构
5962

60-
Architecture
61-
---------------
6263
<img alt="系统架构图" src="https://raw.githubusercontent.com/shinnytech/tqsdk-python/master/doc/arch.svg?sanitize=true">
6364

64-
* [行情网关 (Open Md Gateway)](https://github.com/shinnytech/open-md-gateway) 负责提供实时行情和历史数据
65-
* [交易中继网关 (Open Trade Gateway)](https://github.com/shinnytech/open-trade-gateway) 负责连接到期货公司交易系统
66-
* 这两个网关统一以 [Diff协议](https://doc.shinnytech.com/diff/latest) 对下方提供服务
67-
* TqSdk按照Diff协议连接到行情网关和交易中继网关, 实现行情和交易功能
65+
* 行情网关负责提供实时行情和历史数据
66+
* 交易中继网关负责连接到期货公司交易系统
67+
* 这两个网关统一以Diff协议对下方提供服务
68+
* TqSdk按照Diff协议连接到行情网关和交易中继网关，实现行情和交易功能
69+
70+
## 主要功能特点
71+
72+
TqSdk提供的功能可以支持从简单到复杂的各类策略程序：
6873

74+
* **公司级数据运维**，提供当前所有可交易合约从上市开始的**全部Tick数据和K线数据**
75+
* **多账户支持**，支持使用多个实盘账户、模拟账户同时交易
76+
* **支持市场上90%的期货公司实盘交易**
77+
* **支持股票、期权、期货交易**
78+
* **支持CTP直连交易**，以及众期、融航、杰宜斯等资管柜台，易达、ctpmini 等高速柜台
79+
* **支持模拟交易**
80+
* **支持Tick级和K线级回测**，支持复杂策略回测
81+
* **提供近百个技术指标函数及源码**
82+
* **用户无须建立和维护数据库**，行情和交易数据全在内存数据库，无访问延迟
83+
* **优化支持pandas和numpy库**，方便数据分析
84+
* **灵活的策略编写方式**，无强制框架结构，支持任意复杂度的策略，在一个交易策略程序中使用多个品种的K线/实时行情并交易多个品种
6985

70-
Features
71-
---------------
72-
TqSdk 提供的功能可以支持从简单到复杂的各类策略程序.
86+
* **配合天勤AI助手**，提供函数解释、策略编写指导、错误分析等支持
7387

74-
* **公司级数据运维**，提供当前所有可交易合约从上市开始的 **全部Tick数据和K线数据**
75-
* 支持市场上90%的期货公司 **实盘交易**
76-
* 支持 **模拟交易**
77-
* 支持 **Tick级和K线级回测**, 支持 **复杂策略回测**
78-
* 提供近百个 **技术指标函数及源码**
79-
* 用户无须建立和维护数据库, 行情和交易数据全在 **内存数据库** , 无访问延迟
80-
* 优化支持 **pandas** 和 **numpy** 库
81-
* 无强制框架结构, 支持任意复杂度的策略, 在一个交易策略程序中使用多个品种的K线/实时行情并交易多个品种
82-
* 配合开发者支持工具，能够进行**交易信号打点**，支持**自定义指标画图**
88+
## 安装方法
8389

84-
Installation
85-
-------------------------------------------------
86-
TqSdk 仅支持 Python 3.7 及更高版本. 要安装 TqSdk, 可使用 pip:
90+
TqSdk 仅支持 Python 3.7 及更高版本。要安装 TqSdk，可使用 pip：
8791

88-
``` {.sourceCode .bash}
89-
$ pip install tqsdk
92+
```bash
93+
pip install tqsdk
9094
```
9195

96+
## 文档与社区支持
9297

93-
Documentation
94-
-------------------------------------------------
9598
在线阅读HTML版本文档: https://doc.shinnytech.com/tqsdk/latest
9699

97100
知乎账户【天勤量化】：https://www.zhihu.com/org/tian-qin-liang-hua/activities
98101

99-
天勤AI助手：https://udify.app/chat/im02prcHNEOVbPAx 解释函数，编写demo策略，分析报错原因，它都可以做到！
102+
天勤AI助手：https://www.shinnytech.com/products/tqsdk - 解释函数，编写demo策略，分析报错原因，它都可以做到！
100103

101104
用户交流QQ群: **611806823** (目前只允许给我们点过STAR的同学加入, 加群时请提供github用户名)
102105

103-
104-
Gui
105-
-------------------------------------------------
106-
TqSdk本身自带的web_gui功能，简单一行参数即可支持调用图形化界面，详情参考[web_gui](https://doc.shinnytech.com/pysdk/latest/usage/web_gui.html)
107-
<img alt="TqSdk web_gui" src="https://raw.githubusercontent.com/shinnytech/tqsdk-python/master/doc/images/web_gui_backtest.png">
106+
## 关于我们
108107

109-
About us
110-
-------------------------------------------------
111-
[信易科技](https://www.shinnytech.com) 是专业的期货软件供应商和交易所授权行情服务商. 旗下的快期系列产品已为市场服务超过10年. TqSdk 是[公司开源计划](https://www.shinnytech.com/diff)的一部分.
108+
[信易科技](https://www.shinnytech.com) 是专业的期货软件供应商和交易所授权行情服务商。旗下的快期系列产品已为市场服务超过10年。TqSdk 是公司开源计划的一部分。
112109

113110

114111

‎README.md

Lines changed: 48 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -9,88 +9,85 @@
99
<img src ="https://img.shields.io/github/license/shinnytech/tqsdk-python.svg?color=orange"/>
1010
</p>
1111

12-
TqSdk 天勤量化交易策略程序开发包
13-
====================================
14-
TqSdk 是一个由[信易科技](https://www.shinnytech.com)发起并贡献主要代码的开源 python 库.
15-
依托[快期多年积累成熟的交易及行情服务器体系](https://www.shinnytech.com/diff), TqSdk 支持用户使用极少的代码量构建各种类型的量化交易策略程序,
16-
并提供包含期货、期权、股票的 历史数据-实时数据-开发调试-策略回测-模拟交易-实盘交易-运行监控-风险管理 全套解决方案.
12+
# TqSdk 天勤量化交易策略程序开发包
1713

18-
``` {.sourceCode .python}
14+
TqSdk 是一个由[信易科技](https://www.shinnytech.com)发起并贡献主要代码的开源 Python 库。
15+
TqSdk 支持用户使用极少的代码量构建各种类型的量化交易策略程序，
16+
并提供包含期货、期权、股票的 历史数据-实时数据-开发调试-策略回测-模拟交易-实盘交易-运行监控-风险管理 全套解决方案。
17+
18+
## 快速开始
19+
20+
``` python
1921
from tqsdk import TqApi, TqAuth, TqAccount, TargetPosTask
2022

2123
api = TqApi(TqAccount("H海通期货", "4003242", "123456"), auth=TqAuth("快期账户", "账户密码")) # 创建 TqApi 实例, 指定交易账户
22-
q_1910 = api.get_quote("SHFE.rb1910") # 订阅近月合约行情
23-
t_1910 = TargetPosTask(api, "SHFE.rb1910") # 创建近月合约调仓工具
24-
q_2001 = api.get_quote("SHFE.rb2001") # 订阅远月合约行情
25-
t_2001 = TargetPosTask(api, "SHFE.rb2001") # 创建远月合约调仓工具
24+
q_2309 = api.get_quote("SHFE.rb2309") # 订阅近月合约行情
25+
t_2309 = TargetPosTask(api, "SHFE.rb2309") # 创建近月合约调仓工具
26+
q_2401 = api.get_quote("SHFE.rb2401") # 订阅远月合约行情
27+
t_2401 = TargetPosTask(api, "SHFE.rb2401") # 创建远月合约调仓工具
2628

2729
while True:
2830
api.wait_update() # 等待数据更新
29-
spread = q_1910["last_price"] - q_2001["last_price"] # 计算近月合约-远月合约价差
31+
spread = q_2309["last_price"] - q_2401["last_price"] # 计算近月合约-远月合约价差
3032
print("当前价差:", spread)
3133
if spread > 250:
3234
print("价差过高: 空近月，多远月")
33-
t_1910.set_target_volume(-1) # 要求把1910合约调整为空头1手
34-
t_2001.set_target_volume(1) # 要求把2001合约调整为多头1手
35+
t_2309.set_target_volume(-1) # 要求把2309合约调整为空头1手
36+
t_2401.set_target_volume(1) # 要求把2401合约调整为多头1手
3537
elif spread < 200:
36-
print("价差回复: 清空持仓") # 要求把 1910 和 2001合约都调整为不持仓
37-
t_1910.set_target_volume(0)
38-
t_2001.set_target_volume(0)
38+
print("价差回复: 清空持仓") # 要求把 2309 和 2401合约都调整为不持仓
39+
t_2309.set_target_volume(0)
40+
t_2401.set_target_volume(0)
3941
```
4042

41-
要快速了解如何使用TqSdk, 可以访问我们的 [十分钟快速入门指南](https://doc.shinnytech.com/tqsdk/latest/quickstart.html).
43+
要快速了解如何使用TqSdk，请访问我们的 [十分钟快速入门指南](https://doc.shinnytech.com/tqsdk/latest/quickstart.html)。
4244

45+
## 系统架构
4346

44-
Architecture
45-
---------------
4647
<img alt="系统架构图" src="https://raw.githubusercontent.com/shinnytech/tqsdk-python/master/doc/arch.svg?sanitize=true">
4748

48-
* [行情网关 (Open Md Gateway)](https://github.com/shinnytech/open-md-gateway) 负责提供实时行情和历史数据
49-
* [交易中继网关 (Open Trade Gateway)](https://github.com/shinnytech/open-trade-gateway) 负责连接到期货公司交易系统
50-
* 这两个网关统一以 [Diff协议](https://doc.shinnytech.com/diff/latest) 对下方提供服务
51-
* TqSdk按照Diff协议连接到行情网关和交易中继网关, 实现行情和交易功能
49+
* 行情网关负责提供实时行情和历史数据
50+
* 交易中继网关负责连接到期货公司交易系统
51+
* 这两个网关统一以Diff协议对下方提供服务
52+
* TqSdk按照Diff协议连接到行情网关和交易中继网关，实现行情和交易功能
53+
54+
## 主要功能特点
55+
56+
TqSdk提供的功能可以支持从简单到复杂的各类策略程序：
5257

58+
* **公司级数据运维**，提供当前所有可交易合约从上市开始的**全部Tick数据和K线数据**
59+
* **多账户支持**，支持使用多个实盘账户、模拟账户同时交易
60+
* **支持市场上90%的期货公司实盘交易**
61+
* **支持股票、期权、期货交易**
62+
* **支持CTP直连交易**，以及众期、融航、杰宜斯等资管柜台，易达、ctpmini 等高速柜台
63+
* **支持模拟交易**
64+
* **支持Tick级和K线级回测**，支持复杂策略回测
65+
* **提供近百个技术指标函数及源码**
66+
* **用户无须建立和维护数据库**，行情和交易数据全在内存数据库，无访问延迟
67+
* **优化支持pandas和numpy库**，方便数据分析
68+
* **灵活的策略编写方式**，无强制框架结构，支持任意复杂度的策略，在一个交易策略程序中使用多个品种的K线/实时行情并交易多个品种
5369

54-
Features
55-
---------------
56-
TqSdk 提供的功能可以支持从简单到复杂的各类策略程序.
70+
* **配合天勤AI助手**，提供函数解释、策略编写指导、错误分析等支持
5771

58-
* **公司级数据运维**，提供当前所有可交易合约从上市开始的 **全部Tick数据和K线数据**
59-
* 支持市场上90%的期货公司 **实盘交易**
60-
* 支持 **模拟交易**
61-
* 支持 **Tick级和K线级回测**, 支持 **复杂策略回测**
62-
* 提供近百个 **技术指标函数及源码**
63-
* 用户无须建立和维护数据库, 行情和交易数据全在 **内存数据库** , 无访问延迟
64-
* 优化支持 **pandas** 和 **numpy** 库
65-
* 无强制框架结构, 支持任意复杂度的策略, 在一个交易策略程序中使用多个品种的K线/实时行情并交易多个品种
66-
* 配合开发者支持工具，能够进行**交易信号打点**，支持**自定义指标画图**
72+
## 安装方法
6773

68-
Installation
69-
-------------------------------------------------
70-
TqSdk 仅支持 Python 3.7 及更高版本. 要安装 TqSdk, 可使用 pip:
74+
TqSdk 仅支持 Python 3.7 及更高版本。要安装 TqSdk，可使用 pip：
7175

72-
``` {.sourceCode .bash}
73-
$ pip install tqsdk
76+
```bash
77+
pip install tqsdk
7478
```
7579

80+
## 文档与社区支持
7681

77-
Documentation
78-
-------------------------------------------------
7982
在线阅读HTML版本文档: https://doc.shinnytech.com/tqsdk/latest
8083

8184
知乎账户【天勤量化】：https://www.zhihu.com/org/tian-qin-liang-hua/activities
8285

83-
天勤AI助手：https://udify.app/chat/im02prcHNEOVbPAx 解释函数，编写demo策略，分析报错原因，它都可以做到！
86+
天勤AI助手：https://www.shinnytech.com/products/tqsdk - 解释函数，编写demo策略，分析报错原因，它都可以做到！
8487

8588
用户交流QQ群: **611806823** (目前只允许给我们点过STAR的同学加入, 加群时请提供github用户名)
8689

87-
88-
Gui
89-
-------------------------------------------------
90-
TqSdk本身自带的web_gui功能，简单一行参数即可支持调用图形化界面，详情参考[web_gui](https://doc.shinnytech.com/pysdk/latest/usage/web_gui.html)
91-
<img alt="TqSdk web_gui" src="https://raw.githubusercontent.com/shinnytech/tqsdk-python/master/doc/images/web_gui_backtest.png">
90+
## 关于我们
9291

93-
About us
94-
-------------------------------------------------
95-
[信易科技](https://www.shinnytech.com) 是专业的期货软件供应商和交易所授权行情服务商. 旗下的快期系列产品已为市场服务超过10年. TqSdk 是[公司开源计划](https://www.shinnytech.com/diff)的一部分.
92+
[信易科技](https://www.shinnytech.com) 是专业的期货软件供应商和交易所授权行情服务商。旗下的快期系列产品已为市场服务超过10年。TqSdk 是公司开源计划的一部分。
9693

‎doc/advanced/index.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,3 @@
1717
unanttended.rst
1818
targetpostask2.rst
1919
scheduler.rst
20-
tq_trading_unit.rst

‎doc/conf.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -48,9 +48,9 @@
4848
# built documents.
4949
#
5050
# The short X.Y version.
51-
version = u'3.8.0'
51+
version = u'3.8.1'
5252
# The full version, including alpha/beta/rc tags.
53-
release = u'3.8.0'
53+
release = u'3.8.1'
5454

5555
# The language for content autogenerated by Sphinx. Refer to documentation
5656
# for a list of supported languages.
@@ -182,7 +182,7 @@ def setup(app):
182182

183183

184184
# Example configuration for intersphinx: refer to the Python standard library.
185-
intersphinx_mapping = {'https://docs.python.org/': None}
185+
intersphinx_mapping = {'python': ('https://docs.python.org/3/', None)}
186186

187187
autodoc_member_order = "bysource"
188188

‎doc/enterprise.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,16 @@ TqSdk 企业版
88

99
如果想使用 TqSdk 企业版功能，可以点击 `个人中心 <https://account.shinnytech.com/>`_ 申请15天试用或购买
1010

11+
TqSdk 本地多策略功能
12+
-------------------------------------------------
13+
随着对收益曲线稳定的追求，较多用户需求在一个账户下去运行多个策略，当多个策略交易同一标的时，则面临着不同策略的持仓管理，绩效归因等问题
14+
15+
为了解决该问题， `tqsdk` 在企业版中提供了本地众期多策略系统，支持用户在本地将一个实盘账户拆分为多个策略（多个前端账户），每个策略交易数据相互隔离，且跨日有效
16+
17+
同时该方案会提供多策略的管理界面，支持可视化观察各个多策略的持仓，委托，资金和盈亏情况
18+
19+
TqSdk 本地多策略功能的详细介绍，请点击 :ref:`tq_trading_unit`
20+
1121

1222
TqSdk 直连功能
1323
-------------------------------------------------

‎doc/images/tq_zq_assign.png

43.3 KB
Loading

‎doc/images/tq_zq_backen.png

51.3 KB
Loading

‎doc/images/tq_zq_broker.png

8.41 KB
Loading

‎doc/images/tq_zq_config.png

10.1 KB
Loading

‎doc/images/tq_zq_config2.png

11.9 KB
Loading

‎doc/images/tq_zq_front.png

27.6 KB
Loading

‎doc/images/tq_zq_init.png

8.98 KB
Loading

‎doc/images/tq_zq_strategy.png

25.8 KB
Loading

‎doc/images/tq_zq_unclear_order.png

37.9 KB
Loading

‎doc/index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@ TianQin Python Sdk User Guide
1919
usage/index.rst
2020
demo/index.rst
2121
reference/index.rst
22+
tq_trading_unit.rst
2223
advanced/index.rst
2324
dev/index.rst
2425
profession.rst

0 commit comments

Comments
 (0)