- name
- stk-code-change
- description
- 查询 A 股股票代码变更历史。用户问股票代码变更、原代码、代码迁移、招保诚原代码、001872 之前代码、920000 升板前代码、新三板升北交所时使用。参数 trade_code 必填且需带 .SZ/.SH/.BJ 后缀,支持逗号分隔多个代码。
# 查询 A 股代码变更历史
## 接口说明
| 项目 | 说明 |
|----------|-----------------------------------------------------|
| 接口名称 | 查询 A 股代码变更历史 |
| 外部接口 | `/api/v1/market/data/stk-code-change` |
| 请求方式 | GET |
| 适用场景 | 按股票代码查询其历史代码变更记录及每个代码的起止使用区间 |
## 请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|-------------|--------|----------|-----------------------------------------------------|--------------|-----------------------------------------------------------------------|
| trade_code | string | 是 | 股票最新代码 | 001872.SZ | 带 .SZ/.SH/.BJ 后缀,支持逗号分隔多个,如 `001872.SZ,920000.BJ` |
| start_date | string | 否 | 过滤区间起始日期 | 20180101 | `YYYYMMDD` 格式;与 `end_date` 同时提供时须 `start_date` ≤ `end_date` |
| end_date | string | 否 | 过滤区间结束日期 | 20241231 | `YYYYMMDD` 格式;与 `start_date` 同时提供时须 `start_date` ≤ `end_date` |
## 执行方式
通过根目录的 `run.py` 调用(推荐):
```bash
python <RUN_PY> stk-code-change --trade_code 001872.SZ
python <RUN_PY> stk-code-change --trade_code 001872.SZ,920000.BJ --start_date 20180101 --end_date 20241231
```
> `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径。
## 响应结构
```json
[
{
"trade_code": "001872.SZ",
"code": "1872",
"name": "招商港口",
"start_date": "20181226",
"end_date": null
},
{
"trade_code": "001872.SZ",
"code": "22",
"name": "招商港口",
"start_date": "19930505",
"end_date": "20181225"
}
]
```
### 字段说明
| 字段名 | 类型 | 是否可为空 | 说明 |
|-------------|--------|------------|-----------------------------------------------------------------------------------|
| trade_code | string | 否 | 该股票的最新代码(带 .SZ/.SH/.BJ 后缀) |
| code | string | 否 | 该时段内实际使用的股票代码(带后缀) |
| name | string | 否 | 股票名称 |
| start_date | string | 是 | 该代码开始使用的起始日期(`YYYYMMDD`;最早原代码之前可能为空字符串) |
| end_date | string | 是 | 该代码结束使用的日期(`YYYYMMDD`);`null` 表示当前仍在使用 |
## 注意事项
- `trade_code` 必填,为空时接口返回 400。
- 不分页,按 `trade_code` 返回该股票全部代码变更记录;多 `trade_code`(逗号分隔)时合并返回。
- 日期参数格式为 `YYYYMMDD`,非时间戳。
- 已上市股票的最早区间起始优先使用上市日期。
GitHubで見る