Limit Up Pool

---
name: limit-up-pool
description: Get the limit-up stock pool for today or a historical trade date (当日或指定历史交易日的涨停股池). Use when user asks about 涨停、涨停板、涨停股、封板、今日涨停、当天涨停、某日涨停.
---

# 涨停股池

## 1. 接口描述

| 项目 | 说明 |
|------|------|
| 接口名称 | 查询涨停股池 |
| 外部接口 | `GET /api/v1/market/data/limit-up-pool` |
| 请求方式 | GET |
| 适用场景 | 不传 `trade_date`（或传当日）时返回当日实时涨停股池；传历史交易日时返回该交易日曾涨停的股票（标的代码、涨停价、封板时间、炸板次数等），并已过滤非股票标的（可转债等） |

## 2. 请求参数

| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|--------|------|----------|------|----------|------|
| trade_date | string | 否 | 交易日期，YYYYMMDD | 20260713 | 不传或传当日时查询实时数据 |

## 3. 响应说明

返回 `LimitUpPoolItem` 裸数组（无 code/message 信封）：

| 字段名 | 类型 | 可为空 | 说明 |
|--------|------|--------|------|
| symbol | string | 否 | 标的代码（如 600519.XSHG） |
| trade_date | string | 否 | 交易日期 YYYYMMDD |
| ready | bool | 否 | 当日涨跌停价格是否已就绪 |
| status | string | 否 | 当前状态：`normal`/`limit_up`/`limit_down` |
| limit_up_price | string | 否 | 涨停价（元） |
| limit_up_enter | array[string] | 否 | 进入涨停的时间点，格式 `HH:mm:ss` |
| limit_up_break | array[string] | 否 | 炸板时间数组（空数组表示未炸板） |
| first_limit_up_time | string | 是 | 首次封板时间；无封板记录时为 null |
| limit_up_break_count | uint32 | 否 | 炸板次数（涨停封板后被打开的次数） |

示例响应：
```json
[
  {
    "symbol": "600519.XSHG",
    "trade_date": "20260715",
    "ready": true,
    "status": "limit_up",
    "limit_up_price": "1850.00",
    "limit_up_enter": ["09:32:15"],
    "limit_up_break": [],
    "first_limit_up_time": "09:32:15",
    "limit_up_break_count": 0
  }
]
```

## 4. 用法

```bash
# 当日实时涨停股池
python <RUN_PY> limit-up-pool
# 指定历史交易日
python <RUN_PY> limit-up-pool --trade-date 20260713
```

## 5. 注意事项

- 仅返回 `limit_up_enter` 非空的股票
- 非交易时段调用且未传 `trade_date` 时返回空数组或上一交易日数据
- 传入 `trade_date` 时返回该交易日的已落库涨停股池，不再受实时内存状态限制
- 展示时可用 `stock-security-info`（`https://ftai.chat`）查股票名称，symbol 需转换：`.XSHG`→`.SH`，`.XSHE`→`.SZ`