【QMT】QMT API 教程：动态获取指数或行业成分股

是 否 +2 论坛币

k人 参与回答

经管之家送您一份

应届毕业生专属福利!

求职就业群

赵安豆老师微信：zhaoandou666

经管之家联合CDA

送您一个全额奖学金名额~ !

立即领取

感谢您参与论坛问题回答

经管之家送您两个论坛币！

+2 论坛币

QMT策略技巧：动态获取沪深300等指数成分股的方法解析

在量化交易策略开发中，灵活获取特定时间点的指数、行业或自定义板块的成分股列表是构建精准策略的关键。本文将详细介绍如何利用QMT API中的核心函数实现这一功能，帮助提升策略的历史回测准确性与实盘适应性。

get_sector

get_stock_list_in_sector

一、如何在策略中获取指定时间点的指数成分股？

在QMT环境中，若需获取某一具体时刻的指数成分股名单，应使用以下核心接口：

ContextInfo.get_sector

二、关键函数详解

ContextInfo.get_sector(sector, realtime)

功能说明：该函数用于获取某只指数在指定时间节点下的全部成分股代码列表。

参数说明：

sector

• sector_code（字符串）：指数的标准代码，格式为 XXXXXX.SX，例如：

'code.market'

• '000300.SH' —— 对应沪深300指数

'000300.SH'

• '000905.SH' —— 中证500指数

'000905.SH'

• timestamp（字符串或数值，可选）：目标时间点，推荐传入毫秒级时间戳。若未提供，则默认返回当前最新数据。

realtime

返回值：

list

返回一个包含所有成分股代码的列表，如：['600000.SH', '600004.SH', ...]。

['000001.SZ', '600000.SH', ...]

三、实战代码示例

以下是一个完整的策略片段，展示如何在回测或实盘运行过程中，根据每根K线的时间动态获取对应时点的沪深300成分股。

# -*- coding: gbk -*-
def init(ContextInfo):
    # 初始化函数，可用于设置全局变量
    pass

def handlebar(ContextInfo):
    # 步骤1：获取当前K线的位置索引
    index = ContextInfo.barpos
    
    # 步骤2：获取当前K线对应的时间戳（毫秒级）
    realtime = ContextInfo.get_bar_timetag(index)
    
    # 步骤3：设定目标指数代码
    index_code = '000300.SH'
    
    # 步骤4：调用get_sector获取该时间点的成分股
    stock_list = ContextInfo.get_sector(index_code, realtime)
    
    # 步骤5：输出结果进行验证
    date_str = timetag_to_datetime(realtime, '%Y-%m-%d')
    print(f"日期: {date_str}, 指数: {index_code}, 成分股数量: {len(stock_list)}")
    
    if len(stock_list) > 0:
        print(f"前5只成分股: {stock_list[:5]}")

handlebar

四、重要注意事项

1. 时间戳参数的重要性

realtime

在回测模式下，必须显式传入历史时间戳（如上例中的realtime），否则系统将默认返回最新的成分股列表，导致策略引入“未来信息”，造成回测结果严重失真。

ContextInfo.get_bar_timetag(index)

2. 使用代码还是名称？

• 当使用标准指数代码（如000300.SH）时，建议使用get_sector(sector_code, timestamp)。

'000300.SH'

ContextInfo.get_sector

• 若希望通过中文板块名称查询（如“白酒概念”、“新能源”等），可使用支持名称输入的替代接口。

'沪深300'

'我的自选'

对应的函数为：

ContextInfo.get_stock_list_in_sector(sectorname, realtime)

其用法相似，但第一个参数为中文名称字符串。注意可能存在重名风险，尤其在自定义板块较多时需谨慎处理。

3. 数据准备要求

在执行回测前，请确保已在QMT客户端的【数据管理】模块中下载了相关指数的历史行情及成分股变动记录，以保证历史成分股数据完整准确。

五、常见问题解答

Q：两个不同接口

ContextInfo.get_sector

和

ContextInfo.get_stock_list_in_sector

有何区别？

A：

get_sector

• get_sector(code) 主要适用于标准指数代码（如000300.SH），定位精确，适合大多数指数类策略。

000300.SH

get_stock_list_in_sector

• 而另一版本则通过板块名称（如“医药生物”）进行匹配，适用范围更广，涵盖行业、概念、用户自建板块等，但存在命名冲突的可能性。

沪深300

对于标准指数，推荐优先使用代码方式以避免歧义。

Q：如果

realtime

参数为空会怎样？

A：若省略时间戳参数或传入空值，函数将返回当前系统时间下的最新成分股列表。这在实盘中是合理的，但在回测中会导致使用未来的数据，从而产生误导性的绩效表现。

realtime

Q：如何将毫秒时间戳转换为可读日期？

A：可以使用QMT内置的时间转换工具函数：

timetag_to_datetime(timetag, format)

示例：

timetag_to_datetime(1640995200000, '%Y-%m-%d %H:%M:%S')

即可将时间戳格式化为形如“2025-04-05”的易读字符串。

扫码加我 拉你入群

请注明：姓名-公司-职位

以便审核进群资格，未注明则拒绝

分享0 收藏0 回帖

关键词：API 成分股 realtime datetime Context