## 提示

- `permission-dependent`


## 原型

```python
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类型，包含以下字段；