go/docs/download-second-board-profit-csv.md

# 二板早盘次日盈利接口文档

## 1. 接口说明

本页包含二板早盘次日盈利的列表查询接口和 CSV 下载接口。两个接口使用同一套查询条件和同一套返回字段；列表接口分页，CSV 下载接口导出筛选后的全量数据。

业务筛选基础条件：

- T-2 交易日无涨停。
- T-1 交易日涨停。
- T 交易日涨停。

## 2. 接口地址

| 接口名称 | 请求方式 | 请求路径 | 说明 |
| --- | --- | --- | --- |
| 二板早盘次日盈利列表查询 | `GET` | `/api/v1/limit-board/second-board-profit` | 前端页面分页展示数据 |
| 二板早盘次日盈利 CSV 下载 | `GET` | `/api/v1/download/limit-board/second-board-profit-csv` | 下载筛选条件范围内的全量 CSV 数据 |

## 3. 请求参数

| 参数名 | 类型 | 必填 | 默认值 | 示例 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `tradeStartDate` | `string` | 否 | `2020-01-01` | `2026-01-01` | 交易日开始日期，格式固定为 `YYYY-MM-DD` |
| `tradeEndDate` | `string` | 否 | `2026-12-31` | `2026-12-31` | 交易日结束日期，格式固定为 `YYYY-MM-DD` |
| `limitUpTimeFilterType1` | `string` | 否 | 空 | `>=` | T 日首次涨停时间第一组筛选操作符，支持 `<`、`>`、`<=`、`>=`、`=` |
| `limitUpTimeFilterValue1` | `string` | 否 | 空 | `09:30:00` | T 日首次涨停时间第一组筛选值 |
| `limitUpTimeFilterType2` | `string` | 否 | 空 | `<` | T 日首次涨停时间第二组筛选操作符，支持 `<`、`>`、`<=`、`>=`、`=` |
| `limitUpTimeFilterValue2` | `string` | 否 | 空 | `11:00:00` | T 日首次涨停时间第二组筛选值 |
| `openPctChgFilterType1` | `string` | 否 | 空 | `>=` | T 日开盘涨跌幅第一组筛选操作符，支持 `<`、`>`、`<=`、`>=`、`=` |
| `openPctChgFilterValue1` | `number` | 否 | 空 | `-2` | T 日开盘涨跌幅第一组筛选值，按 `(T日开盘价 - T-1收盘价) / T-1收盘价 * 100` 计算 |
| `openPctChgFilterType2` | `string` | 否 | 空 | `<=` | T 日开盘涨跌幅第二组筛选操作符，支持 `<`、`>`、`<=`、`>=`、`=` |
| `openPctChgFilterValue2` | `number` | 否 | 空 | `3` | T 日开盘涨跌幅第二组筛选值，按 `(T日开盘价 - T-1收盘价) / T-1收盘价 * 100` 计算 |
| `page` | `int` | 否 | `1` | `1` | 仅列表接口支持，页码从 1 开始 |
| `pageSize` | `int` | 否 | `10` | `20` | 仅列表接口支持，每页数量 |

兼容说明：CSV 下载接口仍兼容旧参数 `start_date` 和 `end_date`，建议新调用统一使用 `tradeStartDate` 和 `tradeEndDate`。

筛选规则：

- 每个筛选项最多支持两组条件，第一组为 `Type1 + Value1`，第二组为 `Type2 + Value2`。
- 四个值都可以为空；当某组 `Type` 和 `Value` 都为空时，该组条件不生效。
- 如果某组条件生效，`Type` 和 `Value` 必须同时填写。
- 两组条件同时存在时按 AND 关系过滤，可用于表达区间，例如 `>=09:30:00` 且 `<11:00:00`。
- 时间值支持 `HH:MM`、`HH:MM:SS`、`HHMM`、`HHMMSS` 格式。
- 实际请求 URL 中 `<`、`>`、`=` 等字符建议做 URL 编码，例如 `>=` 编码为 `%3E%3D`，`<` 编码为 `%3C`。
- 后端也兼容数组式传参，例如 `limitUpTimeFilter[]=%3E%3D&limitUpTimeFilter[]=09:30:00&limitUpTimeFilter[]=%3C&limitUpTimeFilter[]=11:00:00`，数组四个值的含义依次等同于 `Type1`、`Value1`、`Type2`、`Value2`。

## 4. 请求示例

列表查询：

```http
GET /api/v1/limit-board/second-board-profit?tradeStartDate=2026-01-01&tradeEndDate=2026-12-31&page=1&pageSize=10
```

带筛选条件的列表查询：

```http
GET /api/v1/limit-board/second-board-profit?tradeStartDate=2026-04-01&tradeEndDate=2026-04-30&limitUpTimeFilterType1=%3E%3D&limitUpTimeFilterValue1=09:30:00&limitUpTimeFilterType2=%3C&limitUpTimeFilterValue2=11:00:00&openPctChgFilterType1=%3E%3D&openPctChgFilterValue1=-2&openPctChgFilterType2=%3C%3D&openPctChgFilterValue2=3&page=1&pageSize=20
```

CSV 下载：

```http
GET /api/v1/download/limit-board/second-board-profit-csv?tradeStartDate=2026-04-01&tradeEndDate=2026-04-30&limitUpTimeFilterType1=%3E%3D&limitUpTimeFilterValue1=09:30:00&limitUpTimeFilterType2=%3C&limitUpTimeFilterValue2=11:00:00&openPctChgFilterType1=%3E%3D&openPctChgFilterValue1=-2&openPctChgFilterType2=%3C%3D&openPctChgFilterValue2=3
```

## 5. 列表响应

| 字段名 | 类型 | 说明 |
| --- | --- | --- |
| `trade_start_date` | `string` | 查询交易日开始日期 |
| `trade_end_date` | `string` | 查询交易日结束日期 |
| `limit_up_time_filter_type1` | `string` | 首次涨停时间第一组筛选操作符 |
| `limit_up_time_filter_value1` | `string` | 首次涨停时间第一组筛选值 |
| `limit_up_time_filter_type2` | `string` | 首次涨停时间第二组筛选操作符 |
| `limit_up_time_filter_value2` | `string` | 首次涨停时间第二组筛选值 |
| `open_pct_chg_filter_type1` | `string` | T 日开盘涨跌幅第一组筛选操作符 |
| `open_pct_chg_filter_value1` | `string` | T 日开盘涨跌幅第一组筛选值 |
| `open_pct_chg_filter_type2` | `string` | T 日开盘涨跌幅第二组筛选操作符 |
| `open_pct_chg_filter_value2` | `string` | T 日开盘涨跌幅第二组筛选值 |
| `page` | `int` | 当前页码 |
| `page_size` | `int` | 每页数量 |
| `total` | `int` | 筛选后的总记录数 |
| `total_pages` | `int` | 总页数 |
| `list` | `array` | 当前页数据 |

`list[]` 字段：

| 字段名 | 类型 | CSV 列名 | 说明 |
| --- | --- | --- | --- |
| `trade_date` | `string` | `交易日` | T 日交易日 |
| `ts_code` | `string` | `股票代码` | TS 股票代码 |
| `name` | `string` | `股票简称` | 股票简称 |
| `market` | `string` | `市场` | 市场信息 |
| `industry` | `string` | `行业` | 所属行业 |
| `previous_open_pct_chg` | `number \| null` | `T-1日开盘涨跌幅%` | T-1 日开盘价相对 T-2 收盘价的涨跌幅百分比 |
| `open_pct_chg` | `number \| null` | `T日开盘涨跌幅%` | T 日开盘价相对 T-1 收盘价的涨跌幅百分比 |
| `next_open_pct_chg` | `number \| null` | `T+1日开盘涨跌幅%` | T+1 日开盘价相对 T 日收盘价的涨跌幅百分比 |
| `next_open_profitable` | `string` | `T+1开盘是否盈利` | T+1 开盘收益大于 0 时为 `是`，否则为 `否`；无次日数据时为 `无次日数据` |
| `next_close_profitable` | `string` | `T+1收盘是否盈利` | T+1 收盘收益大于 0 时为 `是`，否则为 `否`；无次日数据时为 `无次日数据` |
| `next_intraday_profitable` | `string` | `T+1盘中是否可盈利` | T+1 最高收益大于 0 时为 `是`，否则为 `否`；无次日数据时为 `无次日数据` |
| `next_high_profit_pct` | `number \| null` | `T+1最高盈利%` | T+1 最高价相对 T 日收盘价的收益率百分比 |
| `next_low_profit_pct` | `number \| null` | `T+1最低盈利%` | T+1 最低价相对 T 日收盘价的收益率百分比 |
| `break_limit_count` | `int \| null` | `开板次数` | T 日开板次数 |
| `turnover_rate_pct` | `number \| null` | `换手率%` | T 日换手率 |
| `first_limit_time` | `string` | `首次涨停时间` | T 日首次涨停时间，格式化为 `HH:MM:SS` |
| `seal_amount` | `number \| null` | `封单额` | T 日封单额 |
| `amount` | `number \| null` | `成交额` | T 日成交额 |

响应示例：

```json
{
  "trade_start_date": "2026-04-01",
  "trade_end_date": "2026-04-30",
  "limit_up_time_filter_type1": ">=",
  "limit_up_time_filter_value1": "09:30:00",
  "limit_up_time_filter_type2": "<",
  "limit_up_time_filter_value2": "11:00:00",
  "open_pct_chg_filter_type1": ">=",
  "open_pct_chg_filter_value1": "-2",
  "open_pct_chg_filter_type2": "<=",
  "open_pct_chg_filter_value2": "3",
  "page": 1,
  "page_size": 10,
  "total": 26,
  "total_pages": 3,
  "list": [
    {
      "trade_date": "2026-04-24",
      "ts_code": "000001.SZ",
      "name": "示例股份",
      "market": "主板",
      "industry": "软件开发",
      "previous_open_pct_chg": -1.25,
      "open_pct_chg": 1.36,
      "next_open_pct_chg": 2.38,
      "next_open_profitable": "是",
      "next_close_profitable": "否",
      "next_intraday_profitable": "是",
      "next_high_profit_pct": 4.21,
      "next_low_profit_pct": -2.15,
      "break_limit_count": 2,
      "turnover_rate_pct": 18.64,
      "first_limit_time": "09:35:12",
      "seal_amount": 286000000,
      "amount": 1523000000
    }
  ]
}
```

## 6. CSV 响应

- 响应类型：`text/csv; charset=utf-8`
- 响应头：`Content-Disposition: attachment; filename="limit_second_board_profit_YYYYMMDD_YYYYMMDD_daily_detail.csv"`
- CSV 文件带 UTF-8 BOM，便于 Excel 直接打开中文列名。
- CSV 下载接口不分页，默认导出查询条件范围内的全部数据。

CSV 字段顺序：

| 字段名 | 说明 |
| --- | --- |
| `交易日` | T 日交易日 |
| `股票代码` | TS 股票代码 |
| `股票简称` | 股票简称 |
| `市场` | 市场信息 |
| `行业` | 所属行业 |
| `T-1日开盘涨跌幅%` | T-1 日开盘价相对 T-2 收盘价的涨跌幅百分比 |
| `T日开盘涨跌幅%` | T 日开盘价相对 T-1 收盘价的涨跌幅百分比 |
| `T+1日开盘涨跌幅%` | T+1 日开盘价相对 T 日收盘价的涨跌幅百分比 |
| `T+1开盘是否盈利` | T+1 开盘收益大于 0 时为 `是`，否则为 `否`；无次日数据时为 `无次日数据` |
| `T+1收盘是否盈利` | T+1 收盘收益大于 0 时为 `是`，否则为 `否`；无次日数据时为 `无次日数据` |
| `T+1盘中是否可盈利` | T+1 最高收益大于 0 时为 `是`，否则为 `否`；无次日数据时为 `无次日数据` |
| `T+1最高盈利%` | T+1 最高价相对 T 日收盘价的收益率百分比 |
| `T+1最低盈利%` | T+1 最低价相对 T 日收盘价的收益率百分比 |
| `开板次数` | T 日开板次数 |
| `换手率%` | T 日换手率 |
| `首次涨停时间` | T 日首次涨停时间，格式化为 `HH:MM:SS` |
| `封单额` | T 日封单额 |
| `成交额` | T 日成交额 |

## 7. 错误响应

```json
{
  "error": "参数错误"
}
```