## 提示

- `research-only`


## 原型

```python
check_limit(security, query_date=None)
```

## 释义

check_limit 是 PTrade 中用于代码涨跌停状态判断的接口。

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

## 参数

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

## 返回值

正常返回一个dict类型数据，包含每只股票代码的涨停状态。多只股票代码查询时其中部分股票代码查询异常则该代码返回既不涨停也不跌停状态0。(dict[str:int])

涨跌停状态说明：

2：触板涨停(已经是涨停价格，但还有卖盘)(仅支持交易研究查询当日)；

1：涨停；

0：既不涨停也不跌停；

-1：跌停；

-2：触板跌停(已经是跌停价格，但还有买盘)(仅支持交易研究查询当日)；

## 示例

```python
def initialize(context):

g.security = '600570.SS'

set_universe(g.security)

def handle_data(context, data):

# 代码涨跌停状态

stock_flag = check_limit(g.security)[g.security]

log.info(stock_flag)
```

## 详细说明

check_limit(security, query_date=None)

### 使用场景

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

### 接口说明

该接口用于标识股票的涨跌停情况。

### 注意事项

入参的query_date仅支持YYYYmmdd格式的传参，当query_date入参为None或传入当日日期时，返回的结果是以实时最新价判断涨跌停状态；当query_date入参为历史交易日期，则均以交易日收盘价判断涨跌停状态。

### 参数详细说明

security：单只股票代码或者多只股票代码组成的列表，必填字段(list[str]/str)；

query_date：查询日期，查询指定日期股票代码的涨跌停状态，回测不传默认是回测当日时间，交易和研究不传默认是执行当日时间，非必填字段(str)；

### 返回值

正常返回一个dict类型数据，包含每只股票代码的涨停状态。多只股票代码查询时其中部分股票代码查询异常则该代码返回既不涨停也不跌停状态0。(dict[str:int])

涨跌停状态说明：

2：触板涨停(已经是涨停价格，但还有卖盘)(仅支持交易研究查询当日)；

1：涨停；

0：既不涨停也不跌停；

-1：跌停；

-2：触板跌停(已经是跌停价格，但还有买盘)(仅支持交易研究查询当日)；