$npx -y skills add FTShare-Lab/FTShare-skills --skill cb-base-data单只可转债基础信息(market.ft.tech)。用户问可转债基础信息、转债详情、某只可转债、转股价、转股价值、到期日、发行规模时使用。
| 1 | # 单只可转债基础信息 - 查询可转债基础信息 |
| 2 | |
| 3 | ## 1. 接口描述 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |------|------| |
| 7 | | 接口名称 | 查询可转债基础信息 | |
| 8 | | 外部接口 | `GET /api/v1/market/data/cb/cb-base-data` | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 根据转债代码获取单只可转债的完整基础信息;数据为前一交易日可转债基础数据 | |
| 11 | |
| 12 | ## 2. 请求参数 |
| 13 | |
| 14 | 说明:`symbol_code` 为 query 参数(必填)。 |
| 15 | |
| 16 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 17 | |--------|------|----------|------|----------|------| |
| 18 | | symbol_code | string | 是 | 转债代码,可带交易所后缀 | 110070.SH、110070 | 必填 | |
| 19 | |
| 20 | ## 3. 响应说明 |
| 21 | |
| 22 | 返回单条可转债基础信息;各字段均可能为 null。日期类为 YYYYMMDD 整数,金额/规模等为数值型。 |
| 23 | |
| 24 | ```json |
| 25 | { |
| 26 | "cb_name": "恒逸转债", |
| 27 | "full_name": "恒逸石化股份有限公司可转换公司债券", |
| 28 | "cb_id": 110070, |
| 29 | "stock_id": 000703, |
| 30 | "bond_type": "cb", |
| 31 | "value_date": 20201102, |
| 32 | "maturity_date": 20261101, |
| 33 | "par_value": 100, |
| 34 | "conversion_price": 11.29, |
| 35 | "conversion_value": 98.23, |
| 36 | "conversion_premium": 1.8, |
| 37 | "total_issue_size": 2000000000, |
| 38 | "listed_date": 20201116 |
| 39 | } |
| 40 | ``` |
| 41 | |
| 42 | ### CbBaseDataItem 字段 |
| 43 | |
| 44 | | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |
| 45 | |--------|------|------------|------|------| |
| 46 | | cb_name | string | 否 | 债券简称 | - | |
| 47 | | full_name | string | 否 | 债券全称 | - | |
| 48 | | cb_id | int | 否 | 债券代码 | - | |
| 49 | | stock_id | int | 否 | 转债对应正股代码 | - | |
| 50 | | exchange | int | 否 | 交易所 | - | |
| 51 | | bond_type | string | 否 | 债券分类:cb(可转债券)、eb(可交换债券)、STb(单独交易券) | - | |
| 52 | | trade_type | string | 否 | 交易方式:dirty_price(全价)、clean_price(净价) | - | |
| 53 | | value_date | int | 否 | 起息日 | YYYYMMDD | |
| 54 | | maturity_date | int | 否 | 到期日 | YYYYMMDD | |
| 55 | | par_value | float | 否 | 面值 | - | |
| 56 | | coupon_rate | float | 否 | 发行票面利率 | - | |
| 57 | | coupon_frequency | int | 否 | 付息频率 | - | |
| 58 | | coupon_method | string | 否 | 债券计息方式:stepup_rate、fixed_rate | - | |
| 59 | | total_issue_size | float | 否 | 发行总规模 | - | |
| 60 | | de_listed_date | int | 否 | 债券摘牌日 | YYYYMMDD | |
| 61 | | conversion_start_date | int | 否 | 转换期起始日 | YYYYMMDD | |
| 62 | | conversion_end_date | int | 否 | 转换期截止日 | YYYYMMDD | |
| 63 | | redemption_price | float | 是 | 到期赎回价格 | - | |
| 64 | | issue_price | float | 否 | 发行价格 | - | |
| 65 | | call_protection | float | 否 | 强赎保护期(月计) | 月 | |
| 66 | | listed_date | int | 是 | 上市日,未上市为 null | YYYYMMDD | |
| 67 | | stop_trading_date | int | 是 | 停止交易日,未公布为 null | YYYYMMDD | |
| 68 | | conversion_coefficient | float | 是 | 转股系数 | - | |
| 69 | | conversion_value | float | 是 | 转股价值 | - | |
| 70 | | conversion_premium | float | 是 | 转股溢价率 | - | |
| 71 | | conversion_price | float | 否 | 最新转股价 | - | |
| 72 | | amount_converted | int | 是 | 本期转债已转股金额 | 元 | |
| 73 | | shares_converted | float | 是 | 本期转股股数 | - | |
| 74 | | remaining_amount | int | 是 | 尚未转股的转债金额 | 元 | |
| 75 | | total_amount_converted | int | 是 | 累计已转股金额 | 元 | |
| 76 | | total_shares_converted | float | 是 | 累计转股数 | - | |
| 77 | | issue_method | string | 否 | 发行方式 | - | |
| 78 | | list_announcement_date | int | 否 | 上市公告书发布日 | YYYYMMDD | |
| 79 | |
| 80 | ## 4. 用法 |
| 81 | |
| 82 | 通过主目录 `run.py` 调用(必填 `--symbol_code`): |
| 83 | |
| 84 | ```bash |
| 85 | python <RUN_PY> cb-base-data --symbol_code 110070.SH |
| 86 | python <RUN_PY> cb-base-data --symbol_code 110070 |
| 87 | ``` |
| 88 | |
| 89 | `<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON;本接口无需额外请求头。 |
| 90 | |
| 91 | ## 5. 请求示例 |
| 92 | |
| 93 | ``` |
| 94 | GET /api/v1/market/data/cb/cb-base-data?symbol_code=110070.SH |
| 95 | ``` |
| 96 | |
| 97 | ## 6. 注意事项 |
| 98 | |
| 99 | - 数据为前一交易日可转债基础数据,具体以接口返回为准 |
| 100 | - 日期字段(value_date、maturity_date、listed_date 等)为 YYYYMMDD 整数,展示时按需格式化为可读日期 |
| 101 | - 发行总规模、转股金额等大数字展示时可按需换算单位(如万、亿) |
| 102 | - 若用户只给转债名称,建议先用 `cb-lists` 查到对应 `cb_id`/交易所,再拼成 `symbol_code`(如 `110070.SH`)调用本接口 |