企业官网建设流程全解析

一、前言

在期货交易中，主力合约是流动性最好、成交量最大的合约，也是量化交易者最常使用的合约。但主力合约会随时间变化而切换，如何自动获取当前的主力合约代码，是期货量化交易的基础问题。

本文将介绍：

• 什么是期货主力合约
• TqSdk中的主连合约代码
• 如何获取主力合约的实际代码
• 主力合约切换的处理方法

二、为什么选择天勤量化（TqSdk）

在众多期货量化工具中，**天勤量化（TqSdk）**是目前国内最受欢迎的开源期货量化框架之一。本文使用TqSdk获取数据，主要基于以下优势：

安装方法：

pipinstalltqsdk

快期账户：使用TqSdk需要注册快期账户（免费），访问 https://www.shinnytech.com 注册。

三、主力合约基础知识

3.1 什么是主力合约

期货合约有不同的交割月份，例如螺纹钢有rb2501、rb2502、rb2503等多个合约。其中：

为什么要交易主力合约？

1. 流动性好：成交活跃，容易成交
2. 滑点小：买卖价差小
3. 深度好：挂单量充足

3.2 TqSdk的主连合约

TqSdk使用主连合约来表示主力合约，代码格式为：

KQ.m@交易所.品种代码

常见主连合约代码：

四、获取主力合约代码

4.1 最简示例

#!/usr/bin/env python# -*- coding: utf-8 -*-""" 功能：获取期货主力合约的实际代码 说明：本代码仅供学习参考 """fromtqsdkimportTqApi,TqAuth# 创建API实例api=TqApi(auth=TqAuth("快期账户","快期密码"))# 订阅螺纹钢主连quote=api.get_quote("KQ.m@SHFE.rb")# 打印主力合约的实际代码print(f"螺纹钢主连当前对应的合约:{quote.underlying_symbol}")# 关闭APIapi.close()

运行结果：

螺纹钢主连当前对应的合约: SHFE.rb2501

4.2 代码解析

4.3 获取多个品种的主力合约

fromtqsdkimportTqApi,TqAuth api=TqApi(auth=TqAuth("快期账户","快期密码"))# 定义要查询的主连合约symbols=[("螺纹钢","KQ.m@SHFE.rb"),("铁矿石","KQ.m@DCE.i"),("沪深300","KQ.m@CFFEX.IF"),("原油","KQ.m@INE.sc"),("PTA","KQ.m@CZCE.TA"),("甲醇","KQ.m@CZCE.MA"),("豆粕","KQ.m@DCE.m"),("黄金","KQ.m@SHFE.au"),]print("="*50)print(f"{'品种':<10}{'主连代码':<20}{'实际合约':<15}")print("="*50)forname,symbolinsymbols:quote=api.get_quote(symbol)print(f"{name:<10}{symbol:<20}{quote.underlying_symbol:<15}")print("="*50)api.close()

运行结果：

================================================== 品种 主连代码 实际合约 ================================================== 螺纹钢 KQ.m@SHFE.rb SHFE.rb2501 铁矿石 KQ.m@DCE.i DCE.i2501 沪深300 KQ.m@CFFEX.IF CFFEX.IF2501 原油 KQ.m@INE.sc INE.sc2502 PTA KQ.m@CZCE.TA CZCE.TA501 甲醇 KQ.m@CZCE.MA CZCE.MA501 豆粕 KQ.m@DCE.m DCE.m2505 黄金 KQ.m@SHFE.au SHFE.au2502 ==================================================

五、主连合约的用途

5.1 直接用主连合约获取数据

主连合约可以直接用于获取K线和行情数据，会自动获取当前主力合约的数据：

fromtqsdkimportTqApi,TqAuth api=TqApi(auth=TqAuth("快期账户","快期密码"))# 直接用主连代码获取K线klines=api.get_kline_serial("KQ.m@SHFE.rb",60,data_length=100)# 获取主连行情quote=api.get_quote("KQ.m@SHFE.rb")print(f"当前主力合约:{quote.underlying_symbol}")print(f"最新价:{quote.last_price}")print(f"最近5根K线收盘价:")print(klines.tail()['close'].values)api.close()

5.2 监控主力合约切换

主力合约会定期切换，通常在新主力合约的成交量和持仓量超过旧主力时发生：

fromtqsdkimportTqApi,TqAuth api=TqApi(auth=TqAuth("快期账户","快期密码"))quote=api.get_quote("KQ.m@SHFE.rb")current_underlying=quote.underlying_symbolprint(f"初始主力合约:{current_underlying}")whileapi.wait_update():ifapi.is_changing(quote,"underlying_symbol"):new_underlying=quote.underlying_symbolprint(f"主力合约发生切换！")print(f"旧主力:{current_underlying}")print(f"新主力:{new_underlying}")current_underlying=new_underlying

六、指数合约

除了主连合约，TqSdk还提供指数合约，代码格式为：

KQ.i@交易所.品种代码

指数的计算方式：根据在市期货合约的昨持仓量加权平均

fromtqsdkimportTqApi,TqAuth api=TqApi(auth=TqAuth("快期账户","快期密码"))# 获取主连和指数main_quote=api.get_quote("KQ.m@SHFE.rb")index_quote=api.get_quote("KQ.i@SHFE.rb")print(f"螺纹钢主连 最新价:{main_quote.last_price}")print(f"螺纹钢指数 最新价:{index_quote.last_price}")api.close()

七、常见问题

Q1: 主连和具体合约有什么区别？

Q2: 主力合约什么时候切换？

天勤主力的切换标准：

• 新合约的持仓量和成交量均超过旧主力
• 在下一个交易日开盘后进行切换
• 切换后不会再切换回之前的合约

Q3: 如何用主力合约进行实盘交易？

需要先获取实际合约代码，再使用实际合约进行交易：

quote=api.get_quote("KQ.m@SHFE.rb")actual_symbol=quote.underlying_symbol# 获取实际合约代码# 使用actual_symbol进行下单

八、总结

本文介绍了TqSdk获取期货主力合约的方法：

下一步学习：

• 查询合约的详细信息（交易时间、保证金、手续费等）
• 使用TqSdk计算技术指标

免责声明：本文仅供学习交流使用，不构成任何投资建议。期货交易有风险，入市需谨慎。

更多资源：

• 天勤量化官网：https://www.shinnytech.com
• GitHub开源地址：https://github.com/shinnytech/tqsdk-python
• 官方文档：https://doc.shinnytech.com/tqsdk/latest