研究数据可转债可转债数据

可转债基础信息接口文档

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

接口参数与返回字段速查

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

请求参数

  • apiname(string(convertible_basic),必选):固定接口名称,用于选择对应的数据能力。
  • apikey(string,必选):猫爪数据 API Key。网页在线调试会为已登录用户自动注入,其他调用请从控制台获取。
  • fields(string|null,可选):需要返回的字段列表,多个字段使用英文逗号分隔;可选字段见下方返回字段表。
  • params(object,可选):查询条件对象;具体参数、格式和互斥关系见下方 params 参数表。
  • symbols(string|array<string>,可选):转债代码,支持单个代码、多个英文逗号分隔代码或数组;不传则默认全部未摘牌转债。
  • keyword(string,可选):关键词,按转债代码、转债名称、正股代码或正股简称检索。
  • exchange(string,可选):上市交易所,如 SSE、SZSE。
  • list_date(string,可选):上市日期,格式:YYYYMMDD。
  • include_delisted(boolean,可选):是否包含已摘牌转债。默认 false。

返回字段

  • 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):最近一次评级对应的评级机构。