$npx -y skills add FTShare-Lab/FTShare-skills --skill cb-lists可转债全量列表(market.ft.tech)。用户问可转债列表、全部可转债、转债代码列表、有哪些可转债时使用。
| 1 | # 可转债列表 - 获取可转债列表 |
| 2 | |
| 3 | ## 1. 接口描述 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |------|------| |
| 7 | | 接口名称 | 获取可转债列表 | |
| 8 | | 外部接口 | `GET /api/v1/market/data/cb/cb-lists` | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 获取当前可转债全量列表(全称、债券代码、正股代码、交易所);仅包含通过可转债号段判断的标的,数据为前一交易日 | |
| 11 | |
| 12 | ## 2. 请求参数 |
| 13 | |
| 14 | 说明:该接口无需请求参数。 |
| 15 | |
| 16 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 17 | |--------|------|----------|------|----------|------| |
| 18 | | - | - | - | 无需参数 | - | - | |
| 19 | |
| 20 | ## 3. 响应说明 |
| 21 | |
| 22 | 返回可转债列表;无数据时 `items` 为空数组 `[]`。 |
| 23 | |
| 24 | ```json |
| 25 | { |
| 26 | "items": [ |
| 27 | { |
| 28 | "full_name": "恒逸石化股份有限公司可转换公司债券", |
| 29 | "cb_id": 110070, |
| 30 | "stock_id": 703, |
| 31 | "exchange": 1 |
| 32 | }, |
| 33 | { |
| 34 | "full_name": "浙江伟明环保股份有限公司可转换公司债券", |
| 35 | "cb_id": 113643, |
| 36 | "stock_id": 603568, |
| 37 | "exchange": 1 |
| 38 | } |
| 39 | ] |
| 40 | } |
| 41 | ``` |
| 42 | |
| 43 | ### CbListsItem 字段 |
| 44 | |
| 45 | | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |
| 46 | |--------|------|------------|------|------| |
| 47 | | full_name | string | 否 | 债券全称 | - | |
| 48 | | cb_id | int | 否 | 债券代码 | - | |
| 49 | | stock_id | int | 否 | 转债对应正股代码 | - | |
| 50 | | exchange | int | 否 | 交易所 | - | |
| 51 | |
| 52 | ## 4. 用法 |
| 53 | |
| 54 | 通过主目录 `run.py` 调用(无需参数): |
| 55 | |
| 56 | ```bash |
| 57 | python <RUN_PY> cb-lists |
| 58 | ``` |
| 59 | |
| 60 | `<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON;本接口无需额外请求头。 |
| 61 | |
| 62 | ## 5. 请求示例 |
| 63 | |
| 64 | ``` |
| 65 | GET /api/v1/market/data/cb/cb-lists |
| 66 | ``` |
| 67 | |
| 68 | ## 6. 注意事项 |
| 69 | |
| 70 | - 数据为前一交易日可转债列表,具体以接口返回为准 |
| 71 | - 无数据时返回 `{"items": []}` |