## 提示

- `level2`
- `live-or-trading-module-only`


## 原型

```python
get_gear_price(sids)
```

## 释义

get_gear_price 是 PTrade 中用于获取指定代码的档位行情价格的接口。

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

## 参数

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

## 返回值

包含以下信息(dict[str:dict[int:list[float,int,int],...],...])：

bid_grp:委买档位(str:dict[int:list[float,int,int],...])；

offer_grp:委卖档位(str:dict[int:list[float,int,int],...])；

单只代码返回：

{'bid_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]},

'offer_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}}

多只代码返回：

{代码：{'bid_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]},

'offer_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}}

}

## 示例

```python
def initialize(context):

g.security = '600570.SS'

set_universe(g.security)

def handle_data(context, data):

#获取600570.SS当前档位行情

gear_price = get_gear_price('600570.SS')

log.info(gear_price)

#获取600571.SS当前档位行情

gear_price = get_gear_price('600571.SS')

log.info(gear_price)
```

## 详细说明

get_gear_price(sids)

### 使用场景

该函数仅在交易模块可用

### 接口说明

该接口用于获取指定代码的档位行情价格。

### 注意事项

获取实时行情快照失败时返回档位内容为空dict({"bid_grp": {}, "offer_grp": {}})。

若无L2行情时，委托笔数字段返回0。

### 参数详细说明

sids：股票代码(list[str]/str)；

### 返回值

包含以下信息(dict[str:dict[int:list[float,int,int],...],...])：

bid_grp:委买档位(str:dict[int:list[float,int,int],...])；

offer_grp:委卖档位(str:dict[int:list[float,int,int],...])；

单只代码返回：

{'bid_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]},

'offer_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}}

多只代码返回：

{代码：{'bid_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]},

'offer_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}}

}