基础信息

文档 v1.0.67 · 发布快照 1.0.78下载 meoz Skill最新文档

根据服务、资产与周期选择本接口。先核对请求参数,再用响应字段和单位解释结果。

正式接口 · meoz 接口目录

查询可转债基础资料,用于获取转债代码、名称、正股、发行规模、债券余额、转股价、评级和上市摘牌信息。

接口名称 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"}}}}}