## 原型

```python
filter_stock_by_status(stocks, filter_type=["ST", "HALT", "DELISTING"], query_date=None)
```

## 释义

filter_stock_by_status 是 PTrade 中用于过滤指定状态的股票代码的接口。

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

## 参数

| 参数 | 是否必填 | 官方原始定义 |
|---|---:|---|
| `stocks` | 是 | stocks |
| `filter_type` | 否 | filter_type=["ST", "HALT", "DELISTING"] |
| `query_date` | 否 | query_date=None |

## 返回值

股票列表（该列表已剔除符合任一指定状态的标的）(list)

## 示例

```python
def initialize(context):

g.security = ['123002.SZ',"688500.SS","000001.SZ", "603997.SS", '123181.SZ']

set_universe(g.security)

def before_trading_start(context, data):

filter_stock = filter_stock_by_status(g.security, ["ST", "HALT", "DELISTING"])

log.info(filter_stock)

def handle_data(context, data):

pass
```

## 详细说明

filter_stock_by_status(stocks, filter_type=["ST", "HALT", "DELISTING"], query_date=None)

### 使用场景

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

### 接口说明

该接口用于过滤指定状态的股票代码。

### 注意事项

仅支持before_trading_start模块调用

### 参数详细说明

stocks: 例如 ['000001.SZ','000003.SZ']。该字段必须输入。(list[str]/str)；

filter_type: 支持以下四种类型属性的过滤条件，默认为"ST", "HALT", "DELISTING"（str/list）

具体支持输入的字段包括 ：

'ST' - 查询是否属于ST股票

'HALT' - 查询是否停牌

'DELISTING' - 查询是否退市

'DELISTING_SORTING' - 查询是否退市整理期(只过滤交易当日数据)

query_date: 格式为YYYYmmdd，默认为None,表示当前日期(回测为回测当前周期，研究与交易则取系统当前时间)(str)；

### 返回值

股票列表（该列表已剔除符合任一指定状态的标的）(list)