期货数据

期货可交易合约列表

get_future_contracts-期货可交易合约列表

get_future_contracts(security, date=None)

获取某期货品种在某个日期的可交易合约列表（返回一组具体合约代码）。

参数

参数名	类型	必填	说明
security	str	是	期货品种代码，如 'IF'、'IC'、'IH'、'AG'、'RB'
date	datetime.date / datetime.datetime / str / int	否	查询日期。回测模块中不填则默认为策略当前日期；研究模块中不填则默认为最新日期。支持：date/datetime、字符串 'YYYY-MM-DD' / 'YYYY-MM-DD HH:MM:SS'、时间戳（秒/毫秒）。

返回

• list[str]：该日期可交易合约标的列表；可能包含月合约与 L* 类合约
• 若无数据/权限限制等情况，可能返回空列表 []

示例

# 以 IF 为例
contracts = get_future_contracts('IF', date='2025-11-20')
log.info(contracts)

# ['zjIF2511', 'zjIF2512', 'zjIF2603', 'zjIF2606', 'zjIFL7', 'zjIFL8', 'zjIFL9', 'zjIFL0', 'zjIFL1', 'zjIFL2', 'zjIFL3']

ts_ms = 1763568000000
contracts = get_future_contracts('IF', date=ts_ms)
log.info(contracts)