## 提示

- `live-or-trading-module-only`
- `backtest-only`
- `permission-dependent`


## 原型

```python
get_instruments(contract)
```

## 释义

get_instruments 是 PTrade 中用于获取合约信息的接口。

研究：不支持；回测：支持；模拟：官方目录未明确；实盘：支持。

## 参数

| 参数 | 是否必填 | 官方原始定义 |
|---|---:|---|
| `contract` | 是 | contract |

## 返回值

FutureParams对象，dict类型，key为字段名，value为字段值，主要返回的字段为:

## 示例

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

## 详细说明

get_instruments(contract)

### 使用场景

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

### 接口说明

获取合约的上市的具体信息

### 注意事项

期货实盘模块中，由于行情源的限制，涨跌幅目前暂无法提供。

此API依靠期货资料详情数据权限，使用前请与券商确认是否有此权限，无权限时调用返回空dict。

### 参数详细说明

contract：字符串，期货的合约代码，str类型；

### 返回值

FutureParams对象，dict类型，key为字段名，value为字段值，主要返回的字段为: