QMT Python API

因子函数

因子数据

查询因子数据（单表） - get_factor

原型

qmt://docs/python

1from xtquant.cloud.factorapi import get_factor

3get_factor(

4 table, # 表名: 'technical'/'quality'/'growth'/'momentum' 等

5 factor_list, # 因子英文 ID 列表: ['emac5', 'macd']

6 start_date=None,

7 end_date=None,

8 stock_list=None

9)

释义

查询因子数据（单表），通过指定表名和因子英文 ID 列表获取对应时间范围和股票范围内的因子数据。

参数

字段名	数据类型	解释
`table`	`string`	表名，可选值见下方因子分类表，如 `'technical'`、`'quality'`、`'growth'` 等
`factor_list`	`list[string]`	因子英文 ID 列表，如 `['emac5', 'macd']`，可通过 get_factor_id 将中文名转为英文 ID
`start_date`	`string` / `None`	起始日期，格式为 `'20200101'`，`None` 表示不限
`end_date`	`string` / `None`	结束日期，格式为 `'20200101'`，`None` 表示不限
`stock_list`	`list[string]` / `None`	股票代码列表，如 `['600000.SH', '000001.SZ']`，`None` 表示全市场

返回值

pd.DataFrame，列含 instrument_id、trade_date 及各因子值。

示例

qmt://docs/python

1from xtquant.cloud.factorapi import get_factor

3# 查询技术指标表中的 MACD 和 EMA 因子

4df = get_factor(

5 table='technical',

6 factor_list=['emac5', 'macd'],

7 start_date='20230101',

8 end_date='20231231',

9 stock_list=['600000.SH', '000001.SZ']

10)

11print(df.head())

因子中文名转英文 ID - get_factor_id

原型

qmt://docs/python

1from xtquant.cloud.factorapi import get_factor_id

3get_factor_id(factor_name_cn)

释义

将因子中文名转换为因子英文 ID，便于在 get_factor 中作为 factor_list 参数传入。

参数

字段名	数据类型	解释
`factor_name_cn`	`string`	因子中文名，如 `'5日指数移动均线'`

返回值

string，因子英文 ID，如 'emac5'。

示例

qmt://docs/python

1from xtquant.cloud.factorapi import get_factor_id

3# 将中文名转为英文 ID

4factor_id = get_factor_id('5日指数移动均线')

5print(factor_id) # 输出: emac5

ContextInfo 便捷因子查询 - C.get_factor_table

原型

qmt://docs/python

1C.get_factor_table(factor_name)

释义

ContextInfo 中的便捷因子查询方法，按因子中文名查询因子数据，返回含 timetag 列的 DataFrame。这是 ContextInfo 实例方法，无需额外 import。

参数

字段名	数据类型	解释
`factor_name`	`string`	因子中文名，如 `'5日指数移动均线'`

返回值

pd.DataFrame，列含 stock、value、timetag。

示例

qmt://docs/python

1def handlebar(C):

2 # 按中文名查询因子数据

3 df = C.get_factor_table('5日指数移动均线')

4 print(df.head())

因子分类表

因子数据按类别存储在不同的表中，使用 get_factor 时通过 table 参数指定表名。

分类	table 名	示例因子
技术指标	`technical`	MACD, KDJ, RSI, BOLL
质量因子	`quality`	ROE, ROA, 毛利率
成长因子	`growth`	营收增长率, 净利润增长率
每股指标	`per_share`	EPS, BPS, 每股股利
动量因子	`momentum`	1月/3月/6月动量
风格因子	`risk_style`	贝塔, 波动率
情绪因子	`sentiment`	换手率, 资金流
基础衍生	`base_derivative`	PE, PB, PS