Agent Skills
返回列表
⚖️

TqSdk(天勤量化SDK)

行业专业 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/coderwpf-tqsdk-102。

技能介绍

要解决什么问题

国内期货、期权策略往往卡在「行情接口不统一、回测与实盘两套代码、交易所合约代码规则复杂」三件事上。手写对接每家交易所格式、自己维护事件循环,维护成本很高。

TqSdk(天勤量化 SDK) 是信易科技开源的 Python 量化库,用一套异步 API 覆盖行情拉取、历史序列、模拟回测与实盘下单,合约代码按 SHFE.cu2401、DCE.m2405 等规范书写,覆盖上期所、大商所、郑商所、中金所、能源中心、广期所及沪深期权。

技能如何工作

  • 行情:实时报价、K 线、Tick;K 线周期从 3 秒到日线,通过 duration_seconds 指定。
  • 交易与账户:下单、查询持仓与资金;TargetPosTask 可按目标仓位自动开平仓。
  • 回测:与实盘共用业务逻辑,主要差别在 API 初始化方式。
  • 事件模型:api.wait_update() 驱动主循环,配合 api.is_changing() 判断字段是否更新。

文档中的进阶示例包括双合约价差、基于 ATR 的止损、海龟法则、多品种强弱对冲等,可作为策略骨架参考。

适用边界与注意点

免费版行情有约 15 分钟延时,需要 tick 级或盘中实时决策时应考虑专业版。回测报 Backtest data not available 时需核对日期区间与数据授权。认证失败、保证金不足、合约过期或代码写错(如 Symbol not found)需分别检查 TqAuth、 account.available 与合约月份。断网时 SDK 会尝试自动重连,但策略侧仍应做好异常捕获与日志。完整 API 说明见 官方文档。

使用场景

  • 用同一套 Python 策略在上期所、大商所多品种上跑回测,再切换到实盘初始化做小规模验证
  • 监控两个相关期货合约价差,按 Tick 或 1 分钟 K 线触发开平仓逻辑
  • 期权标的需按 SSE/SZSE 代码规则拉行情并配合 TargetPosTask 调整到目标张数
  • 策略主循环里用 wait_update 等待资金、持仓字段变化后再判断是否满足保证金或风控条件

适合人员

  • 独立编写国内商品期货策略、希望在回测与实盘间少改代码的个人量化开发者
  • 需要对接多交易所 K 线周期(如 5 分钟日内与日线趋势)并统一事件循环的私募量化研究员
  • 教学徒生用官方示例(海龟、价差)改参数做课程作业的量化培训讲师
  • 运维自营期权组合、要把目标仓位交给 SDK 自动调仓而非手写逐笔下单的交易员