Skip to content

Commit

Permalink
Update Version 3.7.4
Browse files Browse the repository at this point in the history
  • Loading branch information
@shinny-hongyan @shinny-chenli
shinny-hongyan authored and shinny-chenli committed Oct 31, 2024
1 parent fac614c commit 573ad22
Show file tree
Hide file tree
Showing 26 changed files with 667 additions and 142 deletions.
14 changes: 7 additions & 7 deletions PKG-INFO
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Metadata-Version: 2.1
Name: tqsdk
Version: 3.7.3
Version: 3.7.4
Summary: TianQin SDK
Home-page: https://www.shinnytech.com/tqsdk
Author: TianQin
Expand All @@ -10,7 +10,7 @@ Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6.4
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

Expand All @@ -20,7 +20,7 @@ License-File: LICENSE
<p align="center">
<img src ="https://img.shields.io/pypi/v/tqsdk?color=blueviolet">
<img src ="https://img.shields.io/badge/platform-windows|linux|macos-green.svg"/>
<img src ="https://img.shields.io/badge/python-3.6+-blue.svg" />
<img src ="https://img.shields.io/badge/python-3.7+-blue.svg" />
<img src ="https://img.shields.io/pypi/dm/tqsdk?color=yellowgreen">
<img src ="https://img.shields.io/github/license/shinnytech/tqsdk-python.svg?color=orange"/>
</p>
Expand Down Expand Up @@ -83,7 +83,7 @@ TqSdk 提供的功能可以支持从简单到复杂的各类策略程序.

Installation
-------------------------------------------------
TqSdk 仅支持 Python 3.6 及更高版本. 要安装 TqSdk, 可使用 pip:
TqSdk 仅支持 Python 3.7 及更高版本. 要安装 TqSdk, 可使用 pip:

``` {.sourceCode .bash}
$ pip install tqsdk
Expand All @@ -94,11 +94,11 @@ Documentation
-------------------------------------------------
在线阅读HTML版本文档: https://doc.shinnytech.com/tqsdk/latest

在线问答社区: https://www.shinnytech.com/qa

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

用户交流QQ群: **619870862** (目前只允许给我们点过STAR的同学加入, 加群时请提供github用户名)
天勤AI助手：https://udify.app/chat/im02prcHNEOVbPAx 解释函数，编写demo策略，分析报错原因，它都可以做到！

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


Gui
Expand Down
10 changes: 5 additions & 5 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<p align="center">
<img src ="https://img.shields.io/pypi/v/tqsdk?color=blueviolet">
<img src ="https://img.shields.io/badge/platform-windows|linux|macos-green.svg"/>
<img src ="https://img.shields.io/badge/python-3.6+-blue.svg" />
<img src ="https://img.shields.io/badge/python-3.7+-blue.svg" />
<img src ="https://img.shields.io/pypi/dm/tqsdk?color=yellowgreen">
<img src ="https://img.shields.io/github/license/shinnytech/tqsdk-python.svg?color=orange"/>
</p>
Expand Down Expand Up @@ -67,7 +67,7 @@ TqSdk 提供的功能可以支持从简单到复杂的各类策略程序.

Installation
-------------------------------------------------
TqSdk 仅支持 Python 3.6 及更高版本. 要安装 TqSdk, 可使用 pip:
TqSdk 仅支持 Python 3.7 及更高版本. 要安装 TqSdk, 可使用 pip:

``` {.sourceCode .bash}
$ pip install tqsdk
Expand All @@ -78,11 +78,11 @@ Documentation
-------------------------------------------------
在线阅读HTML版本文档: https://doc.shinnytech.com/tqsdk/latest

在线问答社区: https://www.shinnytech.com/qa

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

用户交流QQ群: **619870862** (目前只允许给我们点过STAR的同学加入, 加群时请提供github用户名)
天勤AI助手：https://udify.app/chat/im02prcHNEOVbPAx 解释函数，编写demo策略，分析报错原因，它都可以做到！

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


Gui
Expand Down
2 changes: 1 addition & 1 deletion doc/advanced/tqsdk2ctptest.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -22,5 +22,5 @@ TqSdk 没有直接提供查询保证金的接口，但是你可以通过使用 T
# 正常和tqsdk一样执行策略


TqSdk2 的直连功能需要企业版权限，有关企业版的具体费用和功能，请参考 `天勤官方网站 <https://www.shinnytech.com/tqsdk_professional/>`_
TqSdk2 的直连功能需要企业版权限，有关企业版的具体费用和功能，请参考 `天勤官方网站 <https://www.shinnytech.com/tqsdk-buy/>`_
如果想了解更多关于 TqSdk2 的直连功能TqCtp，请参考 `tqsdk2官方文档 <https://doc.shinnytech.com/tqsdk2/latest/reference/tqsdk2.ctp.html?highlight=tqctp#tqsdk2.TqCtp/>`_
2 changes: 1 addition & 1 deletion doc/advanced/unanttended.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
TqSdk可以在windows/linux或macosx环境下运行. 无论您选择使用windows或linux系统, 请确保

* 已经装有 Python 3.6+
* 已经装有 Python 3.7+
* 安装 :ref:`TqSdk <tqsdk_install>`

创建一个目录, 放置你所有的策略文件.
Expand Down
4 changes: 2 additions & 2 deletions doc/conf.py
View file
Original file line number Diff line number Diff line change
Expand Up @@ -48,9 +48,9 @@
# built documents.
#
# The short X.Y version.
version = u'3.7.3'
version = u'3.7.4'
# The full version, including alpha/beta/rc tags.
release = u'3.7.3'
release = u'3.7.4'

# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
Expand Down
39 changes: 6 additions & 33 deletions doc/profession.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ TqSdk 中大部分功能是供用户免费使用的, 同时我们也提供了专

此外还提供了丰富的交易手段与监控功能，帮助用户在程序化交易的同时能有一个PC端进行辅助监控与交易

其中的持仓账户监控功能，内置了一基于grafana实时的监控手段，每5s存储一次用户的账户和持仓数据在本地，供用户对这些数据进行可视化分析
其中的持仓账户监控功能，内置了一基于 grafana 实时的监控手段，每10s存储一次用户的账户和持仓数据在本地，供用户对这些数据进行可视化分析

例如回答用户今天的客户权益变动情况，和今天的最大权益和最小权益的发生时间等

Expand All @@ -30,27 +30,20 @@ TqSdk 中大部分功能是供用户免费使用的, 同时我们也提供了专

专业版的行情服务器会在免费版全部升级成功且没有问题之后再进行升级，因此对于 TqSdk 的专业版用户来说，会有更稳定行情服务器连接

更多的实盘交易账户数
更多的期货公司支持
-------------------------------------------------
对于 TqSdk 免费版，每个快期账户支持最多绑定一个实盘账户，而天勤量化专业版支持最多一个快期账户绑定3个实盘账户
对于 TqSdk 免费版，用户只能选择指定的期货公司进行免费实盘交易，专业版支持用户选择其他的期货公司来进行交易

快期账户会在用户使用实盘账户时自动进行绑定，直到该快期账户没有能绑定实盘账户的名额(自动绑定功能需要 TqSdk 版本> 1.8.3)
支持免费实盘交易的期货公司，和 `全部期货公司的名单列表 <https://www.shinnytech.com/blog/tq-support-broker//>`_

TqSdk 免费版和专业版均支持用户绑定3个账户，如需一个快期账户支持更多的实盘账户，请联系工作人员进行批量购买 QQ:532428198

如果需要注册快期账户或者修改您的快期账户绑定的实盘账户，请点击 `登录用户管理中心 <https://account.shinnytech.com/>`_

登录成功后显示如下，在下方红框处,用户可以自行解绑/绑定实盘账户，其中解绑操作每天限定一次

.. figure:: images/user_web_management.png

如需一个快期账户支持更多的实盘账户，请联系工作人员进行批量购买 `个人中心 <https://account.shinnytech.com/>`_

策略回测功能
-------------------------------------------------
:ref:`backtest` 是 TqSdk 专业版中的功能，能让用户在不改变代码的情况下去回测自己的策略在历史行情的表现，并且提供对应的web界面来统计用户的回测表现

.. figure:: images/web_gui_backtest.png

对于 TqSdk 免费版本的用户，每天可以进行3次回测，同时也可以申请模拟账户后模拟运行来检验策略 :ref:`sim_trading`

股票行情
-------------------------------------------------
Expand Down Expand Up @@ -112,29 +105,9 @@ TqSdk 提供了 :py:class:`~tqsdk.TqKqStock` 方法供用户来进行股票的

其他相关函数
-------------------------------------------------
:py:meth:`~tqsdk.TqApi.query_symbol_ranking` 交易所每日成交持仓排名

:py:meth:`~tqsdk.TqApi.get_kline_data_series` 以起始日期获取 Dataframe 格式的 kline 数据

:py:meth:`~tqsdk.TqApi.get_trading_status` 获取指定合约的交易状态，帮助用户实现开盘/跨小节抢单

期权交易 & 交易所组合
-------------------------------------------------
TqSdk 中期权交易(商品期权、金融期权)和交易所官方组合也是 TqSdk 专业版中提供的功能

详细期权说明请点击 :ref:`option_trade`

TqSdk 中期权和交易所组合合约代码参考如下::

DCE.m1807-C-2450 - 大商所豆粕期权
CZCE.CF003C11000 - 郑商所棉花期权
SHFE.au2004C308 - 上期所黄金期权
CFFEX.IO2002-C-3550 - 中金所沪深300股指期权
SSE.10002513 - 上交所上证50etf期权
SSE.10002504 - 上交所沪深300etf期权
SZSE.90000097 - 深交所沪深300etf期权
CZCE.SPD SR901&SR903 - 郑商所 SR901&SR903 跨期合约
DCE.SP a1709&a1801 - 大商所 a1709&a1801 跨期合约

工作时间内的天勤客服支持
-------------------------------------------------
Expand Down
31 changes: 22 additions & 9 deletions doc/quickstart.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -253,25 +253,23 @@ klines是一个pandas.DataFrame对象. 跟 api.get_quote() 一样, api.get_kline

from tqsdk import TqApi, TqAuth, TqAccount

api = TqApi(TqAccount("H海通期货", "412432343", "123456"), auth=TqAuth("快期账户", "账户密码"))
# 如果要更换为徽商期货，只需要改为 H徽商期货
api = TqApi(TqAccount("H宏源期货", "412432343", "123456"), auth=TqAuth("快期账户", "账户密码"))

更多关于实盘交易细节，请点击 :ref:`trade`

目前支持的期货公司列表, 请点击查看: `TqSdk支持的期货公司列表 <https://www.shinnytech.com/blog/tq-support-broker/>`_
其中实盘交易是属于 TqSdk 的专业版功能，用户需要购买 TqSdk 专业版才可以进行实盘交易， `点击申请试用或者购买 <https://account.shinnytech.com/>`_

于此同时，TqSdk 支持在部分的期货公司开户来进行免费的实盘交易，详细期货公司介绍请点击查看 `TqSdk支持的期货公司列表 <https://www.shinnytech.com/blog/tq-support-broker/>`_

注册快期账户，请点击 `登录用户管理中心 <https://www.shinnytech.com/register-intro/>`_

.. _sim_trading:

模拟交易和论坛
-------------------------------------------------
如果您需要使用能保存账户资金及持仓信息的模拟交易功能, 请点击 `注册信易账号 <https://www.shinnytech.com/register-intro/>`_ ，填写完对应信息之后，并验证成功即可进入 `用户论坛 <https://forum.shinnytech.com/>`_ .

.. figure:: images/tq_register.png
如果您需要使用能保存账户资金及持仓信息的模拟交易功能,通过 :py:class:`~tqsdk.TqKq` 对 auth 传入参数进行登录，可以得到一个长期有效的快期模拟账户，快期模拟账户在快期APP、快期专业版、快期v2、快期v3 和天勤量化上是互通的

刚刚注册完成的快期账户的【手机号】/【邮箱地址】/【用户名】和【密码】可以作为 快期模拟 账号，通过 :py:class:`~tqsdk.TqKq` 对 auth 传入参数进行登录，这个 快期模拟 账户在快期APP、快期V3 pro 和天勤量化上是互通的

快期模拟的资金可以通过快期APP、快期专业版的模拟银行进行出入金::
快期模拟的资金可以通过快期APP、快期专业版的模拟银行进行出入金，也可以通过快期专业版对该账户进行重置::

from tqsdk import TqApi, TqAuth, TqKq

Expand All @@ -285,6 +283,21 @@ klines是一个pandas.DataFrame对象. 跟 api.get_quote() 一样, api.get_kline



TqSdk AI 助手
-------------------------------------------------
TqSdk 基于先进的大语言模型和常见天勤问题资料库，提供了新一代的 AI 助手

解释函数，编写demo策略，分析代码报错原因，它都有不错的表现 `点击使用 <https://udify.app/chat/im02prcHNEOVbPAx/>`_

.. figure:: images/llm_pic1.png
.. figure:: images/llm_pic2.png
.. figure:: images/llm_pic3.png
.. figure:: images/llm_pic4.png
.. figure:: images/llm_pic5.png
.. figure:: images/llm_pic6.png
.. figure:: images/llm_pic7.png


TqSdk 学习视频
-------------------------------------------------
TqSdk 提供简单易懂的十分钟上手视频 `供用户学习 <https://www.shinnytech.com/tqsdkquickstart/>`_
Expand Down
2 changes: 1 addition & 1 deletion doc/tqsdk_llm.rst
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.. _tqsdk_llm:

天勤量化机器人助手
天勤量化 AI 助手
-----------------------------------------------
在使用天勤的过程中，用户往往会遇到各种问题，尤其是初学者，他们可能会关心以下几点：

Expand Down
4 changes: 2 additions & 2 deletions doc/usage/backtest.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@
=================================================
策略程序回测是 TqSdk 专业版中的功能，能让用户在不改变代码的情况下去回测自己的策略在历史行情的表现

如果想使用策略回测该功能，可以点击 `天勤量化专业版 <https://www.shinnytech.com/tqsdk_professional/>`_ 申请使用或购买
如果想使用策略回测该功能，可以点击 `天勤量化专业版 <https://www.shinnytech.com/tqsdk-buy/>`_ 申请使用或购买

对于 TqSdk 免费版本的用户，每天可以进行3次回测，同时也可以申请模拟账户后模拟运行来检验策略 :ref:`sim_trading`
用户也可以申请模拟账户后模拟运行来检验策略 :ref:`sim_trading`

执行策略回测
-------------------------------------------------
Expand Down
2 changes: 1 addition & 1 deletion doc/usage/mddatas.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ TqSdk中的合约代码, 统一采用 交易所代码.交易所内品种代码

其中 TqSdk 免费版本提供全部的期货、商品/金融期权和上证50、沪深300、中证500和中证1000的实时行情

购买或申请 TqSdk 专业版试用后可提供A股股票的实时和历史行情，具体免费版和专业版的区别，请点击 `天勤量化专业版 <https://www.shinnytech.com/tqsdk_professional/>`_
购买或申请 TqSdk 专业版试用后可提供A股股票的实时和历史行情，具体免费版和专业版的区别，请点击 `天勤量化专业版 <https://www.shinnytech.com/tqsdk-buy/>`_

目前 TqSdk 支持的交易所包括:

Expand Down
2 changes: 1 addition & 1 deletion doc/usage/option_trade.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
====================================================
TqSdk 中期权交易(商品期权、金融期权和 ETF 期权)和交易所官方组合交易，均是 TqSdk 专业版中的功能

用户如果想在 TqSdk 中进行上述操作，可以点击 `天勤量化专业版 <https://www.shinnytech.com/tqsdk_professional/>`_ 申请使用或购买
用户如果想在 TqSdk 中进行上述操作，可以点击 `天勤量化专业版 <https://www.shinnytech.com/tqsdk-buy/>`_ 申请使用或购买

TqSdk 中期权合和交易所官方组合的约代码格式参考如下::

Expand Down
2 changes: 1 addition & 1 deletion doc/usage/shinny_account.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@

.. figure:: ../images/user_web_management.png

如需一个快期账户支持更多的实盘账户，请联系工作人员进行批量购买 `天勤量化专业版 <https://www.shinnytech.com/tqsdk_professional/>`_
如需一个快期账户支持更多的实盘账户，请联系工作人员进行批量购买 `天勤量化专业版 <https://www.shinnytech.com/tqsdk-buy/>`_



Expand Down
2 changes: 1 addition & 1 deletion doc/usage/trade.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@

.. figure:: ../images/user_web_management.png

如果需要让您的快期账户支持更多的实盘账户，可以购买或申请试用我们的 `天勤量化专业版 <https://www.shinnytech.com/tqsdk_professional/>`_
如果需要让您的快期账户支持更多的实盘账户，可以购买或申请试用我们的 `天勤量化专业版 <https://www.shinnytech.com/tqsdk-buy/>`_

设定实盘交易账户
----------------------------------------------------
Expand Down
9 changes: 8 additions & 1 deletion doc/version.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,13 @@

版本变更
=============================
3.7.4 (2024/10/28)

* 新增：:py:class:`~tqsdk.objs.Quote` 增加属性 :py:meth:`~tqsdk.objs.Quote.position_limit`
* 增加: TqApi 增加 :py:meth:`~tqsdk.TqApi.query_symbol_settlement` 接口，支持查询合约每日结算价
* 增加: TqAuth 增加 :py:meth:`~tqsdk.TqAuth.expire_datetime` 接口，支持查询快期账户授权到期时间
* 自该版本起仅支持 Python >=3.7

3.7.3 (2024/09/20)

* 新增：:py:class:`~tqsdk.TqJees` 账户类型，支持杰宜斯资管柜台
Expand Down Expand Up @@ -739,7 +746,7 @@

2.0.2 (2020/09/18)

* 2020/10/01 以后，免费版用户不再支持回测，下载数据等功能，`点击了解专业版和免费版区别 <https://www.shinnytech.com/tqsdk_professional/>`_
* 2020/10/01 以后，免费版用户不再支持回测，下载数据等功能，`点击了解专业版和免费版区别 <https://www.shinnytech.com/tqsdk-buy/>`_
* 修改中证 500 的合约名称为 SSE.000905
* 修改 TqAccount 检查参数类型并提示用户

Expand Down
6 changes: 3 additions & 3 deletions setup.py
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,17 +8,17 @@

setuptools.setup(
name='tqsdk',
version="3.7.3",
version="3.7.4",
description='TianQin SDK',
author='TianQin',
author_email='[email protected]',
long_description=long_description,
long_description_content_type="text/markdown",
url='https://www.shinnytech.com/tqsdk',
packages=setuptools.find_packages(exclude=["tqsdk.test", "tqsdk.test.*"]),
python_requires='>=3.6.4',
python_requires='>=3.7',
install_requires=["websockets>=8.1", "requests", "numpy", "pandas>=1.1.0", "scipy", "simplejson", "aiohttp",
"certifi", "pyjwt", "psutil", "shinny_structlog", "sgqlc", "filelock", "tqsdk_ctpse", "tqsdk_sm"],
"certifi", "pyjwt", "psutil>=5.9.6", "shinny_structlog", "sgqlc", "filelock", "tqsdk_ctpse", "tqsdk_sm"],
classifiers=[
"Programming Language :: Python :: 3",
"License :: OSI Approved :: Apache Software License",
Expand Down
2 changes: 1 addition & 1 deletion tqsdk/__version__.py
View file
Original file line number Diff line number Diff line change
@@ -1 +1 @@
__version__ = '3.7.3'
__version__ = '3.7.4'
Loading

0 comments on commit 573ad22

Please sign in to comment.