HT套利宝

免责声明： 本软件或开发者明确拒绝对产品做任何明示或暗示的担保。由于软件系统开发本身的复杂性，无法保证产品完全没有错误。您选择使用本软件即表示您同意错误和/或遗漏的存在，在任何情况下本软件/开发者对于直接、间接、特殊的、偶然的、或间接产生的、使用或无法使用本产品进行交易和投资造成的盈亏、直接或间接引起的赔偿、损失、债务或是任何交易中止均不承担责任和义务。
此声明永久有效！

1. 软件名称

  1. 软件名称：HT套利宝
  2. 最新版本：3.0.1
  3. 联系qq : 35200495
  4. 更新日期：2026.4.23

2. 系统模块

  1. 软件入口： main.py,通过参数来启动主策略或实时看板。
  2. 主策略：httaolibao.py,策略的核心模块。
  3. 实盘看板：app.py,可实时监控软件运行状态及收益、持仓信息，可下达开仓指令、平仓指命通知策略进行开仓、平仓。
  4. 配置文件：config.json5,对系统的参数进行配置，可随时修改参数。文件夹/config中的示例配置文件可复制到根目录中使用(需改名为config.json5)。
  5. 软件说明：readme.md，详细说明本软件功能特性。

3. 核心思路

  1. 本策略只操作用户的期货APP用于期货交易，资金和持仓都在用户的期货账户中，确保资金安全。
  2. 由于跨期套利相对于跨品种套利、跨市场套利来说，逻辑更简单，风险更可控，本软件专注于操作跨期套利。
  3. 本软件以均值回归模型、趋势模型、缺口回补模型为基础，批量监控多个品种(理论上没有数量限制，推荐同时监控8-10个品种，以提高资金利用率)，当符合开仓条件时，同时对1个品种的近月合约和远月合约开数量相同、方向相反的仓位；当符合平仓条件时，同时平仓2个合约。
  4. 本策略能实现单策略回测、批量回测、模拟交易、实盘交易4大功能，并设有自动开仓、平仓、止盈、止损，采用全自动方式运行，在必要时也可人为开仓或平仓；
  5. 关键交易信息自动发送到企业微信上提醒；同时提供实时看板供手机随时查看交易状态；所有信息都保存到日志文件中可随时查看异常。
  6. 需要锁定利润或突发异常时，可在实时监控看板强行手动平仓（或在期货APP上平仓）。

2. 功能特性

本策略基于开源组件库：天勤量化tqsdk而开发的一套全自动套利交易软件，能实现期货的单策略回测、批量回测、模拟交易、实盘交易4大功能，具体说明如下：

1. 基本说明

  1. 基于本软件的原理，使用者需对价差、均值、标准差、正向套利、反向套利的概念有一定了解，才能理解并按自己的想法修改配置文件，并合理运行软件。
  2. 本软件数据源为天勤量化平台的实时数据。需在天勤量化官网注册免费帐号，再使用此软件进行回测或交易。
  3. 由于采用对冲套利方式，本软件只能对期货进行交易，不能对股票、基金、外汇等其他金融产品进行交易；
  4. 基于天勤量化所属公司的规定，如果采用天勤的免费帐号，实盘交易只支持3家期货公司（宏源期货、徽商期货，银河期货，具体查看天勤官网）
  5. 此软件进行模拟或实盘时，如果电脑能7*24小时运行，软件会全自动运行，无需人为干预。
  6. 实盘看板的数据每隔5秒刷新1次，如果出现突发异常行情，可在看板上下达平仓指令。
  7. 软件在运行过程中，会实时监控手动在期货APP中平仓的情况，但不能监控手动在期货APP中开仓的情况，请勿在期货APP中手动开仓，否则会导致软件异常。如需手动开仓，请在看板上下达开仓指令，系统会自动处理。
  8. 策略运行过程中，如果出现异常，请及时查看日志文件，并联系客服。

2. 策略功能

  1. 能实现期货的单策略回测、批量回测、模拟交易、实盘交易4大功能，并设有自动开仓、平仓、止盈、止损，采用全自动方式运行，原则上不需人为干预。
  2. 默认同时监控8个品种进行全自动开平仓交易，已对性能进行优化，如果有必要可在配置文件中增加品种（监控的品种必须交易时间相同，不然会有K线数据缺失，带来风险）。
  3. 期货开平仓的成交信息及其它关键信息会实时发送到企业微信/飞书上，具体内容可查看日志文件。但仍需关注策略运行是否出现异常。
  4. 每次平仓后，自动统计胜率、盈亏比、预期年化收益率、最大回撤、盈利金额等信息。

3. 内置规则

  1. 配对合约：为了可操作任何品种，全部采取自定义套利合约，不采用交易所标准套利合约(就算该品种在期货APP中有标准套利合约)。
  2. 开仓平仓：系统支持自动开仓、自动平仓、手动在期货APP中双向平仓（不推荐，如果一定要手动平仓，需在30秒内同时双向平仓），但不支持用户在期货APP中手动开仓，会造成软件逻辑出错带来资金风险（由于用户手动开仓的方式多种多样，无法准确识别）。
  3. 交易下单：开仓时同时开1个品种的2个合约，1个开多仓，1个开空仓，数量相等，方向相反，这是本策略的核心思路。开仓时先开近月合约仓位，再开远月合约仓位。同时每5秒监测一次是否出现单腿风险。
  4. 保证金监控：由于郑州期货交易所不会自动将套利合约合并为单腿保证金，其它交易所会自动合并只占用1份保证金，为了操作任何品种不受限制、避免出现保证金不足，在软件中是按如下规则监控保证金：x = 近月合约保证金+远月合约保证金+500元，当账户余额小于x时,则提醒要补充保证金，但软件运行不受影响（保证金不够的品种不会开仓，其它品种可以正常开仓）。运行时可视实际情况再确定是否要增加保证金。
  5. 保证金计算：由于各期货公司会随时动态调整各品种的保证金率，软件无法随时精确计算保证金，现有配置文件是采用宏源期货2025年7月23日的保证金标准，以实现近似计算。如需精确计算，用户可在配置文件中根据最新保证金率进行更新（参数：default_margin_rate_and_commission）。
  6. 风险控制：本着少亏就是多赚的原则，软件中内置了8大风控规则，在开仓时会首先进行风控校验，如果全部符合才允许开仓，只要有一条不符合，则不允许开仓（日志中有详细记录）。
  7. 开平仓数量：为了控制风险，默认没有启用复利功能（即每次都用最大资金量全额开仓，这会充分利用账户中的资金，避免大量资金闲置，从而提高收益率，高阶版和企业版可开通复利功能），而是不管资金多少，每次开仓都是按配置文件中设定的固定手数开仓（由于同时监控多个品种，为了确保所有品种都能开仓，此时实际上使用的是最小开仓量），具体数量在配置文件中设置。平仓时一次性清仓。
  8. 同时持仓品种：为了控制风险，默认同一时间最多只持仓1个品种，即开仓1个品种后，在平仓之前，其它品种的开仓信息只提示，但不开仓。

4. 单策略回测

  1. 这是默认情况，在配置文件中设好参数后，运行软件即可进行单策略回测。
  2. 由于套利交易中某个品种的配对合约会经常变化，在回测时需在配置文件中指定回测的时间段和配对合约（配置文件中已设默认回测周期和配对合约，可根据自己想法进行修改，在实盘中会自动生成最新配对合约）。
  3. 由于tqsqk的回测引擎底层是针对单边交易，回测结果的胜率统计错误，已在软件中单独设计了一套统计方法，可在回测输出或日志中查看回测的详细统计（由于套利交易的特性，一个品种同时开仓2个合约，平仓时正常1个赚1个亏，按单边交易的统计方法胜率只有50%，但如果此单盈利，实际的胜率为100%，如果此单亏损，胜率为0）

5. 策略批量回测

  1. 软件可以同时对多套参数进行回测，以便找到最佳参数组合。
  2. 由于数据源原因，批量回测时最大线程不能超过10个。
  3. 需要批量回测时，需要在源代码中修改参数池，此在配置文件中无法修改。
  4. 在源代码中设置好参数池后，在配置文件中打开批量回测开关，使super_backtest = 1，运行时将进入批量回测模式。

6. 模拟交易

  1. 模拟交易时，需先在快期APP（天勤量化官方的期货交易APP）的模拟账户中进行银期转帐，转入模拟资金。如果交易配置文件中默认的化工品种，可转入15000，在配置文件中设定开仓数=1.
  2. 模拟交易的持仓、平仓、盈利等信息可在实时看板上查看，实时看板每5秒刷新1次。
  3. 每次平仓后会统计盈利金额、胜率、盈亏比等信息，保存到日志中，并发送到用户的企业微信或飞书（需在配置文件中设置）。
  4. 模拟交易的开仓、风控、平仓逻辑和实盘交易一致。

7. 实盘交易

  1. 实盘交易时，需先在用户的真实期货APP中进行银期转帐，转入真实资金（可先规划好准备开仓的手数，及监控品种的最大保证金再转入，避免资金不足导致开仓失败）。
  2. 当用户在期货APP中直接平仓时，软件在5秒时间内能检测到用户已平仓，并自动处理持仓数据。
  3. 警告：当用户在本软件操作的期货账户APP中直接开仓时，软件无法检测到用户行为，会导致软件异常。如果用户需要开仓，可在实时看板上下达开仓指令，系统会自动处理。或另开一个期货账户手动开仓。
  4. 由于期货交易的特性，用户需主动关注交易状态，并自行承担交易盈亏，如果不能接受，请立即停止使用本软件。

3. 安装指南

由于python软件的特性，为了减少安装过程中的问题点，请按以下推荐步骤安装及使用：

1. 基础环境

  1. 购买一台云服务器，推荐配置为:2核CPU/4G内存/4M网络/带独立公网IP地址/windows server系统，并配置好远程桌面连接方便操作服务器（市场上价格约为100元-200元/年）。
  2. 免费版：直接运行软件目录中的.exe程序即可。
  3. 进阶版(或高阶版、企业版)：
    • 先安装python环境,推荐3.12版。
    • 安装pycharm软件，以虚拟环境方式创建一个新项目，将项目文件复制到新项目目录下(如果用户对python的配置比较熟悉，可直接运行：环境安装.bat，一键安装)。

2. 开通或注册账户

  1. 在指定期货公司开户。(天勤量化免费版能直接实盘交易的期货公司为：宏源期货、徽商期货、银行期货，如已有帐户可跳过)
  2. 注册天勤量化平台帐号。（在天勤量化官网注册帐号，实时时需在天勤量化官网绑定已开通的期货实盘帐号）
  3. 在花牛量化官网注册帐号，免费帐号即可正常使用本软件。

3. 修改策略并回测

  1. 修改策略默认参数，参数配置文件为config.json5。
  2. 进行回测确定最佳策略参数。
  3. 如果配置文件修改后软件无法正常运行，请将: 当前目录\默认配置\config.json5文件，复制到当前目录下，修改参数再使用。

4.设置计划任务

  1. 在服务器的计划任务中添加定时任务，实现每天定时启动和关闭。
  2. 主策略每天启动2次：8:30、20：30（开盘前1小时之内都可以）， 定时启动脚本为：1.套利宝.bat（使用源码时:\启动脚本\HT套利宝.bat)。
  3. 主策略每天关闭2次：15:30、2：30（收盘后1上时之内都可以），定时关闭脚本为：2.关闭套利宝.bat(使用源码时：\启动脚本\kill.bat)。
  4. 实时看板每天启动1次：3:10(由于python的特性，建议每天凌晨自动重启一次)，定时启动脚本为：1.实时看板.bat （使用源码时:\启动脚本\HT实时看板.bat)。.
  5. 实时看板每天关闭1次：3:00(即关闭后再启动)，定时关闭脚本为：2.关闭实时看板.bat （使用源码时:\启动脚本\关闭全部.bat)。
  6. 当前目录下提供了自动生成“计划任务”的脚本，可参考使用。

4. 模拟交易、实盘运行

  1. 在软件根目录点击“1.套利宝.bat”运行软件(使用源码时，启动主策略：python main.py ，或直接双击运行: 当前目录\启动脚本\HT套利宝.bat)。
  2. 根据自定义的最佳策略参数，通过windows"计划任务"'自动启动或关闭套利交易（关键交易信息会自动发送到企业微信），模拟交易推荐1-2个月时间观察效果和问题点。
  3. 修改配置文件，启动实盘交易（关键交易信息会自动发送到企业微信）。
  4. 详细输出信息可查看日志，位于：\data*.log。

5. 启动实时看板

  1. 在软件根目录点击“1.实时看板.bat”运行软件(使用源码时，启动实时看板：python app.py ，或直接双击运行：当前目录\启动脚本\HT实时看板.bat)。
  2. 可用PC浏览器、手机或平板随时查看交易信息(如果是云服务器，需在服务器控制台开通端口，以便手机/平板访问，具体查看云服务器说明)。
  3. 实时看板网址：http://服务器IP:8000。

4. 安装依赖

请确保已安装以下依赖库：
flask
 json5
tinydb
 tqsdk
cryptography
 waitress
* loguru

策略根目标中存在requirements.txt，可执行以下命令一键安装依赖库：
pip install -r requirements.txt
(先修改python的全局设置从阿里云镜像安装模块，可执行命令:
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/)

5. 配置指南

  1. 配置信息存储在config.json5，为json5格式，可根据需求进行修改。
  2. /config下的配置文件为默认配置文件，请不要修改。当config.json5被修改无法使用时，可将config-默认.json5复制到程序目标并改名为config.json5恢复默认状态。
  3. 日志文件存储在data目录下，默认为*.log，可自行查看。
  4. 数据库文件为data/qh_data.json，可用IDE打开查看具体内容。
  5. 配置文件中的参数含义，详见配置文件中的注释。

6. 使用方法

本软件可通过计划任务实现全自动运行，也可以通过命令行手动运行：
1. 启动主策略：python main.py ，也可运行: 当前目标\启动脚本\HT套利宝.bat
2. 启动实时看板：python app.py ，也可运行：当前目标\启动脚本\HT实时看板.bat
3. 看板可常期运行，主策略会通过计划任务定时启停。

7. 各版本详细功能划分

功能模块 免费版 进阶版 高阶版 企业版
策略回测 ✅完整 ✅完整 ✅完整 ✅完整
参数优化 ✅ ✅ ✅ ✅
模拟交易 ✅完整 ✅完整 ✅完整 ✅完整
实盘交易 限1个品种 ✅品种不限 ✅品种不限 ✅品种不限
微信/飞书推送 ❌ ✅ ✅ ✅
源代码 ❌ ❌ ✅永久 ✅永久
服务支持 ❌ 微信群 一对一 一对一
年服务费（咨询/修改/升级） - - ✅含 ✅含
深度定制 ❌ ❌ ❌ ✅

备注： 高阶版源代码永久归用户，年服务费2400元含咨询/修改/升级服务。不续费源码仍可使用。

8. 许可协议

个人可免费使用和修改，但用于商业用途需联系作者获取授权。

9. 更新日志