期货

期货主力合约、次主力合约查询。

期货数据客户端方法集合，对应 /api/futures/* 端点。

get_main_contract(code_market: str, start_time: str = '', end_time: str = '') -> dict

获取期货品种的主力合约。

底层调用 xtdata.get_main_contract()，返回指定期货品种在时间范围内 的主力合约代码。主力合约通常是持仓量最大的合约。

参数：

名称	类型	描述	默认
code_market	str	期货品种代码+市场，如 "IF.IF"（沪深300股指期货）、 "rb.SF"（螺纹钢）、"au.SF"（黄金）	必需
start_time	str	开始时间，格式 "20230101"	''
end_time	str	结束时间	''

返回：

类型	描述
dict	主力合约数据字典，包含各时间点对应的主力合约代码

get_sec_main_contract(code_market: str, start_time: str = '', end_time: str = '') -> dict

获取期货品种的次主力合约。

底层调用 xtdata.get_sec_main_contract()，返回指定期货品种在 时间范围内的次主力合约代码。次主力合约通常是持仓量第二大的合约。

参数：

名称	类型	描述	默认
code_market	str	期货品种代码+市场，如 "IF.IF"	必需
start_time	str	开始时间	''
end_time	str	结束时间	''

返回：

类型	描述
dict	次主力合约数据字典