公式 / 指标

调用自定义公式、批量计算指标、生成自定义指数等。

公式/指标计算客户端方法集合，对应 /api/formula/* 端点。

call_formula(formula_name: str, stock_code: str, period: str = '1d', start_time: str = '', end_time: str = '', count: int = -1, dividend_type: str = 'none', **params) -> dict

对单只股票调用公式/指标计算。

底层调用 xtdata.call_formula()，使用 xtquant 内置的公式引擎 计算技术指标。支持 MA、MACD、RSI、KDJ 等常用技术指标。

参数：

名称	类型	描述	默认
formula_name	str	公式名称，如 "MA"、"MACD"	必需
stock_code	str	股票代码，如 "000001.SZ"	必需
period	str	K 线周期	'1d'
start_time	str	开始时间	''
end_time	str	结束时间	''
count	int	返回条数，-1 表示全部	-1
dividend_type	str	除权类型	'none'
**params		公式额外参数（如 MA 的周期参数）	{}

返回：

类型	描述
dict	公式计算结果字典

call_formula_batch(formula_name: str, stock_codes: list[str], period: str = '1d', start_time: str = '', end_time: str = '', count: int = -1, dividend_type: str = 'none', **params) -> dict

对多只股票批量调用公式/指标计算。

与 call_formula() 功能相同，但支持一次性对多只股票进行计算， 避免逐个请求的网络开销。

参数：

名称	类型	描述	默认
formula_name	str	公式名称	必需
stock_codes	list[str]	股票代码列表	必需
period	str	K 线周期	'1d'
start_time	str	开始时间	''
end_time	str	结束时间	''
count	int	返回条数	-1
dividend_type	str	除权类型	'none'
**params		公式额外参数	{}

返回：

类型	描述
dict	以股票代码为键的计算结果字典

generate_index_data(index_code: str, stocks: list[str], weights: list[float], period: str = '1d', start_time: str = '', end_time: str = '') -> dict

生成自定义指数数据。

根据指定的成分股列表和权重，合成自定义指数的行情数据。 可用于构建行业指数、策略组合等场景。

参数：

名称	类型	描述	默认
index_code	str	自定义指数代码标识	必需
stocks	list[str]	成分股代码列表	必需
weights	list[float]	各成分股的权重列表（与 stocks 一一对应）	必需
period	str	K 线周期	'1d'
start_time	str	开始时间	''
end_time	str	结束时间	''

返回：

类型	描述
dict	合成指数的行情数据字典

create_formula(formula_name: str, formula_file: str, formula_type: str = '') -> dict

创建公式。

参数：

名称	类型	描述	默认
formula_name	str	公式名称	必需
formula_file	str	公式文件路径	必需
formula_type	str	公式类型	''

返回：

类型	描述
dict	创建结果

import_formula(formula_file: str) -> dict

导入公式。

参数：

名称	类型	描述	默认
formula_file	str	公式文件路径	必需

返回：

类型	描述
dict	导入结果

del_formula(formula_name: str) -> dict

删除公式。

参数：

名称	类型	描述	默认
formula_name	str	公式名称	必需

返回：

类型	描述
dict	删除结果

get_formulas() -> dict

获取公式列表。

返回：

类型	描述
dict	公式列表