可转债数据

可转债基础信息接口文档

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

POST/apiapiname:convertible_basic

生产专线（默认）深圳http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api

请求参数

参数	类型	是否必选	示例值	描述
`apiname`	string（convertible_basic）	必选	`convertible_basic`	固定接口名称，用于选择对应的数据能力。
`apikey`	string	必选	`—`	猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
`fields`	string\|null	可选	`symbol,bond_short_name,stk_code,stk_short_name,cb_type,list_date,delist_date,exchange,remain_size,conv_price`	需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
`params`	object	可选	`{"symbols":"123196","include_delisted":false}`	查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。

`params` 参数

参数	类型	是否必选	示例值	描述
`symbols`	string\|array<string>	可选	`123196`	转债代码，支持单个代码、多个英文逗号分隔代码或数组；不传则默认全部未摘牌转债。
`keyword`	string	可选	`转债`	关键词，按转债代码、转债名称、正股代码或正股简称检索。
`exchange`	string	可选	`SSE`	上市交易所，如 SSE、SZSE。
`list_date`	string	可选	`20240115`	上市日期，格式：YYYYMMDD。
`include_delisted`	boolean	可选	`false`	是否包含已摘牌转债。默认 false。

`fields` 返回字段

字段顺序与接口样例保持一致

字段	类型	名称	示例值	描述
`code`	string	完整转债代码	`123196.SZ`	包含交易所后缀的可转债代码。
`symbol`	string	转债代码	`123196`	6 位可转债代码。
`bond_full_name`	string\|null	转债全称	`正元智慧集团股份有限公司可转换公司债券`	可转债完整名称。
`bond_short_name`	string\|null	转债简称	`正元转02`	可转债证券简称。
`cb_code`	string\|null	转股申报代码	`123196`	办理转股时使用的申报代码。
`cb_type`	string\|null	转债类型	`CB`	CB=可转债、EB=可交换债。
`stk_code`	string\|null	正股代码	`300645.SZ`	包含交易所后缀的正股代码。
`stk_short_name`	string\|null	正股简称	`正元智慧`	对应正股的证券简称。
`maturity`	number\|null	发行期限（年）	`6`	债券从发行至到期的期限。
`par`	number\|null	面值（元）	`100`	每张债券的票面金额。
`issue_price`	number\|null	发行价格（元）	`100`	每张债券的发行价格。
`issue_size`	number\|null	发行总额（元）	`500000000`	本次债券发行总金额。
`remain_size`	number\|null	债券余额（元）	`436000000`	当前尚未转股或赎回的债券余额。
`value_date`	string\|null	起息日期	`20240115`	日期格式：YYYYMMDD。
`maturity_date`	string\|null	到期日期	`20300114`	日期格式：YYYYMMDD。
`rate_type`	string\|null	利率类型	`累进利率`	债券票面利率的设置方式。
`coupon_rate`	number\|null	票面利率（%）	`0.5`	当前计息年度的票面利率。
`add_rate`	number\|null	补偿利率（%）	`8`	到期赎回等条款约定的补偿利率。
`pay_per_year`	integer\|null	年付息次数	`1`	每年支付利息的次数。
`list_date`	string\|null	上市日期	`20240206`	日期格式：YYYYMMDD。
`delist_date`	string\|null	摘牌日期	`—`	日期格式：YYYYMMDD；尚未摘牌时返回 null。
`exchange`	string\|null	上市交易所	`SZSE`	可转债上市交易所。
`conv_start_date`	string\|null	转股起始日期	`20240719`	日期格式：YYYYMMDD。
`conv_end_date`	string\|null	转股截止日期	`20300114`	日期格式：YYYYMMDD。
`conv_stop_date`	string\|null	停止转股日期	`—`	日期格式：YYYYMMDD；未停止转股时返回 null。
`first_conv_price`	number\|null	初始转股价（元）	`18.25`	发行时确定的初始转股价格。
`conv_price`	number\|null	最新转股价（元）	`16.8`	当前有效的转股价格。
`rate_clause`	string\|null	利率条款	`第一年0.5%，第二年0.7%`	债券各计息年度的利率约定。
`put_clause`	string\|null	回售条款	`满足约定条件时可回售`	投资者回售权的触发条件与安排。
`maturity_call_price`	string\|null	到期赎回价格（含税）	`115.00`	数据源以文本返回的价格。
`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	发行信用等级	`AA`	债券发行时的信用评级。
`newest_rating`	string\|null	最新信用等级	`AA`	最近一次披露的信用评级。
`rating_comp`	string\|null	评级机构	`中证鹏元`	最近一次评级对应的评级机构。

请求与响应样例

固定样例

{
  "apiname": "convertible_basic",
  "apikey": "YOUR_API_KEY",
  "fields": "symbol,bond_short_name,stk_code,stk_short_name,cb_type,list_date,delist_date,exchange,remain_size,conv_price",
  "params": {
    "symbols": "123196",
    "include_delisted": false
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "fields": [
      "symbol",
      "bond_short_name",
      "stk_code",
      "stk_short_name",
      "cb_type",
      "list_date",
      "delist_date",
      "exchange",
      "remain_size",
      "conv_price"
    ],
    "items": [
      [
        "123196",
        "正元转02",
        "300645.SZ",
        "正元智慧",
        "CB",
        "20240206",
        null,
        "SZSE",
        436000000,
        16.8
      ]
    ]
  }
}

请求参数

params 参数

fields 返回字段

请求与响应样例

`params` 参数

`fields` 返回字段