get_dominant_contract - 获取主力合约代码

get_dominant_contract 是 PTrade 中用于获取主力合约代码的接口。

提示

  • permission-dependent

原型

get_dominant_contract(contract, date=None)

释义

get_dominant_contract 是 PTrade 中用于获取主力合约代码的接口。

研究:支持;回测:支持;模拟:官方目录未明确;实盘:支持。

参数

参数 是否必填 官方原始定义
contract contract
date date=None

返回值

期货连续合约对应的主力合约相关信息,dict类型,key为主力合约,value为dict类型,包含以下字段;

示例

当前官方章节未提供可独立抽取的示例代码。请根据函数签名和参数说明构造调用,并在对应运行环境验证。

详细说明

get_dominant_contract(contract, date=None)

使用场景

该函数在研究、回测、交易模块可用

接口说明

获取连续合约的主力合约代码

注意事项

此API依靠期货主力合约与对应月合约数据权限,使用前请与券商确认是否有此权限,无权限时调用返回空dict。

参数详细说明

contract:字符串,期货的连续合约代码,str类型;

date:查询日期,不入参默认为当前日期,入参查询历史日期时支持datetime类型和str类型(仅支持'YYYY-mm-dd'和'YYYYmmdd'格式);

返回值

期货连续合约对应的主力合约相关信息,dict类型,key为主力合约,value为dict类型,包含以下字段;