stk-code-change

# 查询 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`，非时间戳。 - 已上市股票的最早区间起始优先使用上市日期。