70 lines
2.7 KiB
Markdown
70 lines
2.7 KiB
Markdown
# 二板早盘次日盈利 CSV 下载接口文档
|
|
|
|
## 1. 接口说明
|
|
|
|
- 接口名称：二板早盘次日盈利 CSV 下载
|
|
- 请求方式：`GET`
|
|
- 请求路径：`/api/v1/download/limit-board/second-board-profit-csv`
|
|
- 接口用途：下载符合二板早盘开盘阈值条件的股票明细，并查看后一交易日是否盈利。
|
|
|
|
## 2. 请求参数
|
|
|
|
| 参数名 | 类型 | 必填 | 默认值 | 示例 | 说明 |
|
|
| --- | --- | --- | --- | --- | --- |
|
|
| `start_date` | `string` | 否 | `2020-01-01` | `2026-01-01` | 开始交易日期，格式固定为 `YYYY-MM-DD` |
|
|
| `end_date` | `string` | 否 | `2026-12-31` | `2026-12-31` | 结束交易日期，格式固定为 `YYYY-MM-DD` |
|
|
|
|
- `start_date` 可以等于 `end_date`，用于下载单日数据。
|
|
- `end_date` 不能早于 `start_date`。
|
|
|
|
请求示例：
|
|
|
|
```http
|
|
GET /api/v1/download/limit-board/second-board-profit-csv?start_date=2026-01-01&end_date=2026-12-31
|
|
```
|
|
|
|
单日下载示例：
|
|
|
|
```http
|
|
GET /api/v1/download/limit-board/second-board-profit-csv?start_date=2026-04-29&end_date=2026-04-29
|
|
```
|
|
|
|
## 3. 响应说明
|
|
|
|
- 响应类型：`text/csv; charset=utf-8`
|
|
- 响应头：`Content-Disposition: attachment; filename="limit_second_board_profit_YYYYMMDD_YYYYMMDD_daily_detail.csv"`
|
|
- CSV 文件带 UTF-8 BOM，便于 Excel 直接打开中文列名。
|
|
|
|
## 4. CSV 字段
|
|
|
|
| 字段名 | 说明 |
|
|
| --- | --- |
|
|
| `交易日` | 符合条件的交易日 |
|
|
| `前一交易日` | 交易日的前一个交易日 |
|
|
| `前二交易日` | 交易日的前两个交易日 |
|
|
| `后一交易日` | 用于判断盈利的后一交易日 |
|
|
| `股票代码` | TS 股票代码 |
|
|
| `股票简称` | 股票名称 |
|
|
| `市场` | 市场信息 |
|
|
| `行业` | 所属行业 |
|
|
| `T日开盘价` | 交易日开盘价 |
|
|
| `T日收盘价` | 交易日收盘价 |
|
|
| `T日涨停价` | 理论涨停价 |
|
|
| `T-1收盘价` | 前一交易日收盘价 |
|
|
| `开盘/T-1收盘%` | 交易日开盘价相对前一交易日收盘价的百分比 |
|
|
| `首次涨停时间` | 交易日首次涨停时间，格式化为 `HH:MM:SS` |
|
|
| `T+1开盘收益%` | 后一交易日开盘价相对 T 日收盘价的收益率 |
|
|
| `T+1最高收益%` | 后一交易日最高价相对 T 日收盘价的收益率 |
|
|
| `T+1收盘收益%` | 后一交易日收盘价相对 T 日收盘价的收益率 |
|
|
| `T+1收盘是否盈利` | `T+1收盘收益% > 0` 时为 `是`，否则为 `否` |
|
|
| `T+1盘中是否可盈利` | `T+1最高收益% > 0` 时为 `是`，否则为 `否` |
|
|
|
|
## 5. 业务规则
|
|
|
|
- T 日涨停。
|
|
- T-1 交易日也涨停。
|
|
- T-2 交易日必须不涨停。
|
|
- T 日开盘价必须低于 T-1 收盘价的 101%。
|
|
- T 日首次涨停时间必须早于 11:00。
|
|
- 盈利口径默认按 T 日收盘价买入，T+1 收盘价卖出。
|