## 提示

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


## 原型

```python
get_positions(security)
```

## 释义

get_positions 是 PTrade 中用于获取多只标的持仓信息的接口。

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

## 参数

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

## 返回值

返回一个数据字典，键为股票代码，值为Position对象(dict[str:Position])，如下：

注意：四位尾缀或者两位尾缀代码皆可作为键取到返回的数据字典值，如'600570.XSHG'或者'600570.SS'。

{'600570.XSHG': <Position {'business_type': 'stock', 'short_amount': 0, 'contract_multiplier': 1, 'short_pnl': 0, 'delivery_date': None, 'today_short_amount': 0, 'last_sale_price': 118.7, 'sid': '600570.SS',

'enable_amount': 100, 'margin_rate': 1, 'amount': 200, 'long_amount': 0, 'short_cost_basis': 0, 'today_long_amount': 0, 'cost_basis': 117.9, 'long_pnl': 0, 'long_cost_basis': 0}>}

## 示例

```python
def initialize(context):

g.security = ['600570.SS','600000.SS']

set_universe(g.security)

def handle_data(context, data):

log.info(get_positions('600570.SS'))

log.info(get_positions(g.security))

log.info(get_positions())
```

## 详细说明

get_positions(security)

### 使用场景

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

### 接口说明

该接口用于获取多个标的的持仓信息详情。

### 注意事项

无

### 参数详细说明

security：标的代码，可以是一个列表，不传时默认为获取所有持仓(list[str]/str)；

支持品种：

股票

ETF

LOF

期货

### 返回值

返回一个数据字典，键为股票代码，值为Position对象(dict[str:Position])，如下：

注意：四位尾缀或者两位尾缀代码皆可作为键取到返回的数据字典值，如'600570.XSHG'或者'600570.SS'。

{'600570.XSHG': <Position {'business_type': 'stock', 'short_amount': 0, 'contract_multiplier': 1, 'short_pnl': 0, 'delivery_date': None, 'today_short_amount': 0, 'last_sale_price': 118.7, 'sid': '600570.SS',

'enable_amount': 100, 'margin_rate': 1, 'amount': 200, 'long_amount': 0, 'short_cost_basis': 0, 'today_long_amount': 0, 'cost_basis': 117.9, 'long_pnl': 0, 'long_cost_basis': 0}>}