基础信息
根据服务、资产与周期选择本接口。先核对请求参数,再用响应字段和单位解释结果。
查询可转债基础资料,用于获取转债代码、名称、正股、发行规模、债券余额、转股价、评级和上市摘牌信息。
接口名称 convertible_basic
请求方法 POST /api
- https://sz.meoz.cn:6688
- https://sh.meoz.cn:6688
返回字段
| 字段 | 名称 | 类型 | 描述 | 单位 |
|---|---|---|---|---|
| code | 完整转债代码 | string | 包含交易所后缀的可转债代码。 | |
| symbol | 转债代码 | string | 6 位可转债代码。 | |
| bond_full_name | 转债全称 | string|null | 可转债完整名称。 | |
| bond_short_name | 转债简称 | string|null | 可转债证券简称。 | |
| cb_code | 转股申报代码 | string|null | 办理转股时使用的申报代码。 | |
| cb_type | 转债类型 | string|null | CB=可转债、EB=可交换债。 | |
| stk_code | 正股代码 | string|null | 包含交易所后缀的正股代码。 | |
| stk_short_name | 正股简称 | string|null | 对应正股的证券简称。 | |
| maturity | 发行期限(年) | number|null | 债券从发行至到期的期限。 | |
| par | 面值(元) | number|null | 每张债券的票面金额。 | |
| issue_price | 发行价格(元) | number|null | 每张债券的发行价格。 | |
| issue_size | 发行总额(元) | number|null | 本次债券发行总金额。 | |
| remain_size | 债券余额(元) | number|null | 当前尚未转股或赎回的债券余额。 | |
| value_date | 起息日期 | string|null | 日期格式:YYYYMMDD。 | |
| maturity_date | 到期日期 | string|null | 日期格式:YYYYMMDD。 | |
| rate_type | 利率类型 | string|null | 债券票面利率的设置方式。 | |
| coupon_rate | 票面利率(%) | number|null | 当前计息年度的票面利率。 | |
| add_rate | 补偿利率(%) | number|null | 到期赎回等条款约定的补偿利率。 | |
| pay_per_year | 年付息次数 | integer|null | 每年支付利息的次数。 | |
| list_date | 上市日期 | string|null | 日期格式:YYYYMMDD。 | |
| delist_date | 摘牌日期 | string|null | 日期格式:YYYYMMDD;尚未摘牌时返回 null。 | |
| exchange | 上市交易所 | string|null | 可转债上市交易所。 | |
| conv_start_date | 转股起始日期 | string|null | 日期格式:YYYYMMDD。 | |
| conv_end_date | 转股截止日期 | string|null | 日期格式:YYYYMMDD。 | |
| conv_stop_date | 停止转股日期 | string|null | 日期格式:YYYYMMDD;未停止转股时返回 null。 | |
| first_conv_price | 初始转股价(元) | number|null | 发行时确定的初始转股价格。 | |
| conv_price | 最新转股价(元) | number|null | 当前有效的转股价格。 | |
| rate_clause | 利率条款 | string|null | 债券各计息年度的利率约定。 | |
| put_clause | 回售条款 | string|null | 投资者回售权的触发条件与安排。 | |
| maturity_call_price | 到期赎回价格(含税) | string|null | 数据源以文本返回的价格。 | |
| maturity_put_price | 到期赎回价格(停用字段) | string|null | 旧字段,已停用,请使用 maturity_call_price。 | |
| call_clause | 赎回条款 | string|null | 发行人赎回权的触发条件与安排。 | |
| reset_clause | 转股价修正条款 | string|null | 转股价格修正的触发条件与程序。 | |
| conv_clause | 转股条款 | string|null | 可转债转换为股票的主要约定。 | |
| guarantor | 担保人 | string|null | 债券担保主体;无担保时返回 null。 | |
| guarantee_type | 担保方式 | string|null | 债券增信或担保方式。 | |
| issue_rating | 发行信用等级 | string|null | 债券发行时的信用评级。 | |
| newest_rating | 最新信用等级 | string|null | 最近一次披露的信用评级。 | |
| rating_comp | 评级机构 | string|null | 最近一次评级对应的评级机构。 |
请求
{"content":{"application/json":{"example":{"apikey":"","apiname":"convertible_basic","fields":"symbol,bond_short_name,stk_code,stk_short_name,cb_type,list_date,delist_date,exchange,remain_size,conv_price","params":{"include_delisted":false,"symbols":"123196"}},"schema":{"properties":{"apikey":{"default":"","description":"浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。","type":"string"},"apiname":{"default":"convertible_basic","description":"接口名称","enum":["convertible_basic"],"type":"string"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"symbol,bond_short_name,stk_code,stk_short_name,cb_type,list_date,delist_date,exchange,remain_size,conv_price","description":"| 字段 | 类型 | 名称 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `code` | `string` | 完整转债代码 | `123196.SZ` | 包含交易所后缀的可转债代码。 |\n| `symbol` | `string` | 转债代码 | `123196` | 6 位可转债代码。 |\n| `bond_full_name` | `string\\|null` | 转债全称 | `正元智慧集团股份有限公司可转换公司债券` | 可转债完整名称。 |\n| `bond_short_name` | `string\\|null` | 转债简称 | `正元转02` | 可转债证券简称。 |\n| `cb_code` | `string\\|null` | 转股申报代码 | `123196` | 办理转股时使用的申报代码。 |\n| `cb_type` | `string\\|null` | 转债类型 | `CB` | CB=可转债、EB=可交换债。 |\n| `stk_code` | `string\\|null` | 正股代码 | `300645.SZ` | 包含交易所后缀的正股代码。 |\n| `stk_short_name` | `string\\|null` | 正股简称 | `正元智慧` | 对应正股的证券简称。 |\n| `maturity` | `number\\|null` | 发行期限(年) | `6` | 债券从发行至到期的期限。 |\n| `par` | `number\\|null` | 面值(元) | `100` | 每张债券的票面金额。 |\n| `issue_price` | `number\\|null` | 发行价格(元) | `100` | 每张债券的发行价格。 |\n| `issue_size` | `number\\|null` | 发行总额(元) | `500000000` | 本次债券发行总金额。 |\n| `remain_size` | `number\\|null` | 债券余额(元) | `436000000` | 当前尚未转股或赎回的债券余额。 |\n| `value_date` | `string\\|null` | 起息日期 | `20240115` | 日期格式:YYYYMMDD。 |\n| `maturity_date` | `string\\|null` | 到期日期 | `20300114` | 日期格式:YYYYMMDD。 |\n| `rate_type` | `string\\|null` | 利率类型 | `累进利率` | 债券票面利率的设置方式。 |\n| `coupon_rate` | `number\\|null` | 票面利率(%) | `0.5` | 当前计息年度的票面利率。 |\n| `add_rate` | `number\\|null` | 补偿利率(%) | `8` | 到期赎回等条款约定的补偿利率。 |\n| `pay_per_year` | `integer\\|null` | 年付息次数 | `1` | 每年支付利息的次数。 |\n| `list_date` | `string\\|null` | 上市日期 | `20240206` | 日期格式:YYYYMMDD。 |\n| `delist_date` | `string\\|null` | 摘牌日期 | `null` | 日期格式:YYYYMMDD;尚未摘牌时返回 null。 |\n| `exchange` | `string\\|null` | 上市交易所 | `SZSE` | 可转债上市交易所。 |\n| `conv_start_date` | `string\\|null` | 转股起始日期 | `20240719` | 日期格式:YYYYMMDD。 |\n| `conv_end_date` | `string\\|null` | 转股截止日期 | `20300114` | 日期格式:YYYYMMDD。 |\n| `conv_stop_date` | `string\\|null` | 停止转股日期 | `null` | 日期格式:YYYYMMDD;未停止转股时返回 null。 |\n| `first_conv_price` | `number\\|null` | 初始转股价(元) | `18.25` | 发行时确定的初始转股价格。 |\n| `conv_price` | `number\\|null` | 最新转股价(元) | `16.8` | 当前有效的转股价格。 |\n| `rate_clause` | `string\\|null` | 利率条款 | `第一年0.5%,第二年0.7%` | 债券各计息年度的利率约定。 |\n| `put_clause` | `string\\|null` | 回售条款 | `满足约定条件时可回售` | 投资者回售权的触发条件与安排。 |\n| `maturity_call_price` | `string\\|null` | 到期赎回价格(含税) | `115.00` | 数据源以文本返回的价格。 |\n| `maturity_put_price` | `string\\|null` | 到期赎回价格(停用字段) | `null` | 旧字段,已停用,请使用 maturity_call_price。 |\n| `call_clause` | `string\\|null` | 赎回条款 | `满足约定条件时可提前赎回` | 发行人赎回权的触发条件与安排。 |\n| `reset_clause` | `string\\|null` | 转股价修正条款 | `满足约定条件时可向下修正` | 转股价格修正的触发条件与程序。 |\n| `conv_clause` | `string\\|null` | 转股条款 | `转股期内可按有效转股价转股` | 可转债转换为股票的主要约定。 |\n| `guarantor` | `string\\|null` | 担保人 | `null` | 债券担保主体;无担保时返回 null。 |\n| `guarantee_type` | `string\\|null` | 担保方式 | `无担保` | 债券增信或担保方式。 |\n| `issue_rating` | `string\\|null` | 发行信用等级 | `AA` | 债券发行时的信用评级。 |\n| `newest_rating` | `string\\|null` | 最新信用等级 | `AA` | 最近一次披露的信用评级。 |\n| `rating_comp` | `string\\|null` | 评级机构 | `中证鹏元` | 最近一次评级对应的评级机构。 |"},"params":{"default":{"include_delisted":false,"symbols":"123196"},"description":"| 参数 | 类型 | 是否必选 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `symbols` | `string\\|array` | 可选 | `123196` | 转债代码,支持单个代码、多个英文逗号分隔代码或数组;不传则默认全部未摘牌转债。 |\n| `keyword` | `string` | 可选 | `转债` | 关键词,按转债代码、转债名称、正股代码或正股简称检索。 |\n| `exchange` | `string` | 可选 | `SSE` | 上市交易所,如 SSE、SZSE。 |\n| `list_date` | `string` | 可选 | `20240115` | 上市日期,格式:YYYYMMDD。 |\n| `include_delisted` | `boolean` | 可选 | `false` | 是否包含已摘牌转债。默认 false。 |","properties":{"exchange":{"description":"上市交易所,如 SSE、SZSE。","example":"SSE","type":"string"},"include_delisted":{"default":false,"description":"是否包含已摘牌转债。默认 false。","example":false,"type":"boolean"},"keyword":{"description":"关键词,按转债代码、转债名称、正股代码或正股简称检索。","example":"转债","type":"string"},"list_date":{"description":"上市日期,格式:YYYYMMDD。","example":"20240115","pattern":"^\\d{8}$","type":"string"},"symbols":{"description":"转债代码,支持单个代码、多个英文逗号分隔代码或数组;不传则默认全部未摘牌转债。","example":"123196","oneOf":[{"description":"单个代码或多个英文逗号分隔代码","type":"string"},{"description":"可转债代码数组","items":{"type":"string"},"type":"array"}]}},"type":"object"}},"required":["apikey","apiname"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apiname` | `string` | 必选 | `convertible_basic` | 接口名称 |\n| `apikey` | `string` | 必选 | [访问个人中心获取](/console) | 访问密钥 |","required":true}
响应
{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"业务状态码,200 表示成功","example":200,"type":"integer"},"data":{"description":"可转债基础信息返回数据","nullable":true,"properties":{"fields":{"description":"返回字段名列表,顺序与 items 中每一列一一对应","example":["symbol","bond_short_name","stk_code","stk_short_name","cb_type","list_date","delist_date","exchange","remain_size","conv_price"],"items":{"type":"string"},"type":"array"},"items":{"description":"二维数组数据,每一行代表一条记录,列顺序与 fields 一一对应","example":[["123196","正元转02","300645.SZ","正元智慧","CB","20240206",null,"SZSE",436000000,16.8]],"items":{"items":{},"type":"array"},"type":"array"}},"required":["fields","items"],"type":"object"},"message":{"description":"响应消息","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Successful Response"},"429":{"content":{"application/json":{"schema":{"properties":{"code":{"example":429,"type":"integer"},"data":{"example":null,"nullable":true},"message":{"example":"请求频率超限:daily_auc_detail 接口的调用上限为 3 次/秒,请降低该接口的调用频率,建议 1 秒后重试。","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"账户总调用频率或单个重接口调用频率超过当前套餐限额。","headers":{"Retry-After":{"description":"建议等待后重试的秒数。","schema":{"minimum":1,"type":"integer"}}}}}