Ricequant Docs
  • RQSDK快速上手
  • RQData - 金融数据 API

    • Python API文档
    • Http API文档
  • RQAlpha Plus - 回测框架

    • 使用教程
    • API使用手册 (opens new window)
  • RQFactor - 因子投研工具

    • 使用教程
    • API使用手册
  • RQOptimizer - 股票组合优化器

    • 使用教程
    • API使用手册 (opens new window)
  • RQPAttr - 绩效归因工具

    • 使用教程
  • RQAMS 用户说明文档
  • RQAMSC 说明文档
量化平台文档
米筐帮助中心
返回官网
  • RQSDK快速上手
  • RQData - 金融数据 API

    • Python API文档
    • Http API文档
  • RQAlpha Plus - 回测框架

    • 使用教程
    • API使用手册 (opens new window)
  • RQFactor - 因子投研工具

    • 使用教程
    • API使用手册
  • RQOptimizer - 股票组合优化器

    • 使用教程
    • API使用手册 (opens new window)
  • RQPAttr - 绩效归因工具

    • 使用教程
  • RQAMS 用户说明文档
  • RQAMSC 说明文档
量化平台文档
米筐帮助中心
返回官网
  • RQData金融数据API文档

    • 文档目录
    • 使用说明
    • 跨品种通用API
    • A股
    • 港股(公测版本)
    • 金融、商品期货
    • 金融、商品期权
    • 指数、场内基金
    • 基金
    • 可转债
      • 可转债行情数据说明
      • 可转债基础信息,历史日行情、分钟线
        • convertible.instruments - 获取可转债合约基础信息
        • convertible.all_instruments - 获取所有可转债合约
        • convertible.get_conversion_price - 获取可转债转股价信息
        • convertible.get_conversion_info - 获取可转债转股导致的规模变动情况
        • convertible.get_call_info - 获取可转债强赎信息
        • convertible.get_put_info - 获取可转债回售信息
        • convertible.get_cash_flow - 获取可转债的现金流
        • convertible.is_suspended - 判断可转债是否全天停牌
        • convertible.get_instrument_industry - 获取转债所属行业分类信息
        • convertible.get_industry - 获取指定行业分类下的转债列表
        • convertible.get_accrued_interest_eod - 获取可转债日终应计利息
        • convertible.get_call_announcement - 获取可转债赎回提示性公告数据
        • convertible.get_close_price - 获取可转债全价净价数据
      • 可转债衍生数据
        • convertible.get_indicators - 获取可转债衍生指标
        • convertible.get_credit_rating - 获取可转债债项评级数据
        • convertible.get_std_discount - 获取可转债标准劵折算率
    • 风险因子
    • 现货
    • 货币市场
    • 宏观经济
    • 一致预期(今日投资合作)
    • 新闻舆情(数库合作)
    • ESG(秩鼎合作)
    • 财务指标数据字典
    • 技术指标数据字典
    • 米筐特色指数
    • 更新履历

# 可转债行情数据说明

可获取可转债合约的日行情、分钟行情、tick 行情数据,具体调用方式请参考 API-get_price.

# 可转债基础信息,历史日行情、分钟线

# convertible.instruments - 获取可转债合约基础信息

convertible.instruments(order_book_ids)

获取债券合约基础信息。

# 参数

参数 类型 说明
order_book_ids str OR str list 可转债流通场所代码,可传入 order_book_id, order_book_id list。

# 返回

  • 传入一个 order_book_id,函数会返回一个instrument object
  • 传入多个 order_book_id,函数会返回一个instrument object list
字段 类型 说明
order_book_id str 可转债合约代码
full_name str 债券全称
symbol str 债券简称
call_protection integer 强赎保护期(月计),即此段时间不可强制赎回
issue_price float 发行价格
total_issue_size float 发行总规模
listed_date datetime 上市日
de_listed_date datetime 债券摘牌日
stop_trading_date datetime 停止交易日
value_date datetime 起息日
maturity_date datetime 到期日(初期公告披露的日期)
early_maturity_date datetime 实际到期日
par_value float 面值
coupon_rate float 发行票面利率
coupon_frequency float 付息频率
compensation_rate float 到期补偿利率
conversion_start_date datetime 转换期起始日
conversion_end_date datetime 转换期截止日
redemption_price float 到期赎回价格
stock_code str 对应股票的 order_book_id
exchange str 交易所
coupon_method str 债券计息方式
trade_type str 交易方式
bond_type str 债券分类
eb 可交换债券
cb 可转换债券
separately_traded 就是上交所和深交所公布的可分离债
issue_method str 发行方式
list_announcement_date datetime 上市公告书发布日
pref_allocation_registration_date datetime 老股东优先配售股权登记日
pref_allocation_payment_end_date datetime 老股东优先配售缴款日

转债 Instrument 对象支持 coupon_rate_table()方法来获取不同付息期的票息率:

coupon_rate_table()

转债 Instrument 对象支持 option()方法来获取赎回和回售条款:

convertible.instruments().option(option_type=None)

其中参数 option_type 可以支持输入 int 类型 1~7 ,代表含义参考下表。默认返回全部类型

option_type 值 说明
1 到期赎回权
2 发行人赎回权
3 有条件回售权
4 附加回售权
5 无条件回售权
6 时点回售权
7 价格修正权

option()方法返回结构为pandas DataFrame,返回字段如下:

字段 类型 说明
option_type int 权利类型
start_date datetime 起止日期
end_date datetime 结束日期
level float 触发比例
window_days int 触发天数
reach_days int 满足天数
frequency int 类型
payment_year int 计息年度序列
if_include_interest bool 是否包含利息
price float 价格
remark str 备注

# 范例

  • 获取 110074.XSHE 的基础信息:
[In]convertible.instruments("110074.XSHE")
[Out]
    Instrument(
    order_book_id='110074.XSHG',
    symbol='精达转债',
    full_name='铜陵精达特种电磁线股份有限公司公开发行可转换公司债券',
    exchange='XSHG',
    bond_type='cb',
    trade_type='dirty_price',
    value_date=datetime.datetime(2020, 8, 19, 0, 0),
    listed_date=datetime.datetime(2020, 9, 21, 0, 0),
    maturity_date=datetime.datetime(2026, 8, 19, 0, 0),
    early_maturity_date=None,
    par_value=100.0,
    coupon_rate=0.004,
    coupon_frequency=1,
    coupon_method='stepup_rate',
    compensation_rate=0.1,
    total_issue_size=787000000.0,
    de_listed_date=datetime.datetime(2026, 8, 19, 0, 0),
    stock_code='600577.XSHG',
    conversion_start_date=datetime.datetime(2021, 2, 25, 0, 0),
    conversion_end_date=datetime.datetime(2026, 8, 18, 0, 0),
    redemption_price=112.0,
    stop_trading_date=None,
    issue_price=100.0,
    issue_method='上网定价,老股东优先配售',
    list_announcement_date=datetime.datetime(2020, 9, 17, 0, 0),
    pref_allocation_registration_date=datetime.datetime(2020, 8, 18, 0, 0),
    pref_allocation_payment_end_date=datetime.datetime(2020, 8, 19, 0, 0),
    call_protection=6.0
    )
  • 获取 110030.XSHG 格力转债的票息率
[In]convertible.instruments("110030.XSHG").coupon_rate_table()
[Out]
					coupon_rate
start_date	end_date
2014-12-25	2015-12-24	0.6
2015-12-25	2016-12-24	0.8
2016-12-25	2017-12-24	1.0
2017-12-25	2018-12-24	1.5
2018-12-25	2019-12-24	6.0
  • 获取 110058.XSHG 赎回和回售条款
[In]convertible.instruments('110058.XSHG').option()
[Out]
option_type	start_date	end_date	payment_year	level	window_days	reach_days	frequency	price	if_include_interest	remark
0	1	NaT	NaT	NaN	NaN	NaN	NaN	NaN	110.0	True	(1)到期赎回条款\r\n 在本次发行的可转换公司债券期满后5个交易日内,公司...
1	2	2019-10-22	2025-04-15	1.0	1.30	30.0	15.0	随时	100.4	True	(2)有条件赎回条款\r\n 在本次发行的可转换公司债券转股期内,当下述两种情...
2	2	2019-10-22	2025-04-15	2.0	1.30	30.0	15.0	随时	100.6	True	(2)有条件赎回条款\r\n 在本次发行的可转换公司债券转股期内,当下述两种情...
3	2	2019-10-22	2025-04-15	3.0	1.30	30.0	15.0	随时	101.0	True	(2)有条件赎回条款\r\n 在本次发行的可转换公司债券转股期内,当下述两种情...
4	2	2019-10-22	2025-04-15	4.0	1.30	30.0	15.0	随时	101.5	True	(2)有条件赎回条款\r\n 在本次发行的可转换公司债券转股期内,当下述两种情...
5	2	2019-10-22	2025-04-15	5.0	1.30	30.0	15.0	随时	101.8	True	(2)有条件赎回条款\r\n 在本次发行的可转换公司债券转股期内,当下述两种情...
6	2	2019-10-22	2025-04-15	6.0	1.30	30.0	15.0	随时	102.0	True	(2)有条件赎回条款\r\n 在本次发行的可转换公司债券转股期内,当下述两种情...
7	3	2023-04-16	2025-04-16	5.0	0.70	30.0	30.0	每计息年度1次	101.8	True	(1)有条件回售条款\r\n 在本次发行的可转换公司债券最后两个计息年度,如果...
8	3	2023-04-16	2025-04-16	6.0	0.70	30.0	30.0	每计息年度1次	102.0	True	(1)有条件回售条款\r\n 在本次发行的可转换公司债券最后两个计息年度,如果...
9	4	NaT	NaT	NaN	NaN	NaN	NaN	NaN	NaN	NaN	(2)附加回售条款\r\n 若公司本次发行的可转换公司债券募集资金投资项目的实...
10	7	2019-04-16	2025-04-16	NaN	0.85	30.0	15.0	随时	NaN	NaN	NaN

# convertible.all_instruments - 获取所有可转债合约

convertible.all_instruments(date=None)

获取所有可转债基础信息,传入日期可筛选该日上市状态合约列表

# 返回

  • 传入一个DataFrame
字段 类型 说明
order_book_id str 可转债合约代码
full_name str 债券全称
symbol str 债券简称
call_protection integer 强赎保护期(月计),即此段时间不可强制赎回
issue_price float 发行价格
total_issue_size float 发行总规模
listed_date datetime 上市日
de_listed_date datetime 债券摘牌日
stop_trading_date datetime 停止交易日
value_date datetime 起息日
maturity_date datetime 到期日(初期公告披露的日期)
early_maturity_date datetime 实际到期日
par_value float 面值
coupon_rate float 发行票面利率
coupon_frequency float 付息频率
compensation_rate float 到期补偿利率
conversion_start_date datetime 转换期起始日
conversion_end_date datetime 转换期截止日
redemption_price float 到期赎回价格
stock_code str 对应股票的 order_book_id
exchange str 交易所
coupon_method str 债券计息方式
trade_type str 交易方式
bond_type str 债券分类
eb 可交换债券
cb 可转换债券
separately_traded 就是上交所和深交所公布的可分离债
issue_method str 发行方式
list_announcement_date datetime 上市公告书发布日
pref_allocation_registration_date datetime 老股东优先配售股权登记日
pref_allocation_payment_end_date datetime 老股东优先配售缴款日

# 范例

  • 获取所有可转债基础信息:
[In]convertible.all_instruments()
[Out]
 	order_book_id 	symbol 	full_name 	exchange 	bond_type 	trade_type 	value_date 	maturity_date 	par_value 	coupon_rate 	... 	coupon_method 	 	total_issue_size
0 	100001.XSHG 	南化转债 	南宁化工股份有限公司可转换公司债券 	XSHG 	convertible 	clean_price 	1998-08-03 	2003-08-03 	100.0 	1.00 	... 	stepup_rate 	 	1.500000e+08
1 	100009.XSHG 	机场转债 	上海国际机场股份有限公司可转换公司债券 	XSHG 	convertible 	clean_price 	2000-02-25 	2005-02-25 	100.0 	0.80 	... 	fixed_rate 	 	1.350000e+09
2 	100016.XSHG 	民生转债 	中国民生银行股份有限公司可转换公司债券 	XSHG 	convertible 	clean_price 	2003-02-27 	2008-02-27 	100.0 	1.50 	... 	fixed_rate 	 	4.000000e+09
...

# convertible.get_conversion_price - 获取可转债转股价信息

convertible.get_conversion_price(order_book_ids, start_date=None, end_date=None)

获取可转债合约一段时期的转股价变动。信息来源为交易所的可转债转股统计公告。

# 参数

参数 类型 说明
order_book_ids str OR str list 可转债流通场所代码,可传入 order_book_id, order_book_id list。
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期,默认为初始的信息发布日
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期,默认为当前日期

# 返回

  • 返回DataFrame
字段 类型 说明
info_date datetime 交易所信息发布日期
conversion_price float 本次转股价
effective_date datetime 转股价截止日期

# 范例

  • 获取 110013.XSHG 的截止某日的转股价变动情况:
[In]convertible.get_conversion_price('110013.XSHG',end_date=20110704)
[Out]
 		                      conversion_price 	effective_date
order_book_id 	info_date
110013.XSHG 	2011-01-21 	7.29 	            2011-01-25
              2011-07-04 	7.27 	            2011-07-04

# convertible.get_conversion_info - 获取可转债转股导致的规模变动情况

convertible.get_conversion_info(order_book_ids, start_date=None, end_date=None)

获取可转债合约一段时期的转股规模变动。

# 参数

参数 类型 说明
order_book_ids str OR str list 可转债流通场所代码,可传入 order_book_id, order_book_id list。
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期,默认为初始的信息发布日
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期,默认为当前日期

# 返回

  • 返回DataFrame
字段 类型 说明
info_date datetime 信息发布日
total_amount_converted integer 累计转债已经转为股票的金额(元),累计每次转股金额
total_shares_converted float 累计转股数
remaining_amount integer 尚未转股的转债金额(元)
amount_converted integer 本期转债已转为股票的金额(元), 近似本期转股价与转股数乘积取值
shares_converted integer 本期转股股数
end_date datetime 截止日期
conversion_price float 本次转股价

# 范例

  • 获取 110044.XSHG 的转股规模变动情况:
[In]convertible.get_conversion_info('110044.XSHG')
[Out]
 		                       amount_converted 	conversion_price 	end_date 	remaining_amount 	shares_converted 	total_amount_converted 	total_shares_converted
order_book_id 	info_date
110044.XSHG 	2019-01-04 	455562.48 	                   6.91 	2019-01-03 	7.995444e+08             65928.0 	  4.555625e+05 	         65928.0
              2019-01-07 	683792.87 	                   6.91 	2019-01-04 	7.988606e+08             98957.0 	  1.139355e+06 	         164885.0
              2019-01-08 	86068043.98                    	6.91 	2019-01-07 	7.127926e+08             12455578.0 	8.720740e+07          	12620463.0
              2019-01-09 	38735269.53                    	6.91 	2019-01-08 	6.740573e+08             5605683.0 	1.259427e+08 	         18226146.0
              2019-01-10 	70718653.68                    	6.91 	2019-01-09 	6.033387e+08             10234248.0 	1.966613e+08          	28460394.0
...

# convertible.get_call_info - 获取可转债强赎信息

convertible.get_call_info(order_book_ids, start_date=None, end_date=None)

获取可转债合约一段时期的强制赎回信息。

# 参数

参数 类型 说明
order_book_ids str OR str list 可转债流通场所代码,可传入 order_book_id, order_book_id list。
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期,默认为初始的信息发布日
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期,默认为当前日期

# 返回

  • 返回DataFrame
字段 类型 说明
info_date datetime 信息发布日
exercise_price float 行权价格
interest_included integer 0 对应不包含,1 对应包含。Null 对应不明确
interest_amount float 应计利息
exercise_date datetime 行权日
call_amount integer 赎回债券票面金额
record_date datetime 理论登记日,不跳过假日

# 范例

  • 获取 110020.XSHG 的强赎情况:
[In]convertible.get_call_info('110020.XSHG')
[Out]
		                        call_amount 	exercise_date 	exercise_price 	interest_amount 	interest_included 	record_date
order_book_id  info_date
110020.XSHG 	 2015-01-22 	  8111000.0 	    2015-03-11 	   104.0 	              1.6 	                   1 	  2015-03-10

# convertible.get_put_info - 获取可转债回售信息

convertible.get_put_info(order_book_ids, start_date=None, end_date=None)

获取可转债合约一段时期的持有人回售信息。

# 参数

参数 类型 说明
order_book_ids str OR str list 可转债流通场所代码,可传入 order_book_id, order_book_id list。
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期,默认为初始的信息发布日
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期,默认为当前日期

# 返回

  • 返回DataFrame
字段 类型 说明
info_date datetime 信息发布日
exercise_price float 行权价格
interest_included integer 0 对应不包含,1 对应包含。Null 对应不明确
interest_amount float 应计利息
enrollment_start_date datetime 回售登记开始日期
enrollment_end_date datetime 回售登记结束日期
payment_date datetime 资金到账日
put_amount integer 回售债券票面金额
put_code str 回售代码

# 范例

  • 获取 132002.XSHG 的回售情况:
[In]convertible.get_put_info('132002.XSHG')
[Out]
		                       enrollment_end_date 	enrollment_start_date 	exercise_price 	interest_amount 	interest_included 	payment_date 	put_amount 	  put_code
order_book_id 	info_date
132002.XSHG 	2018-06-25            2018-07-06 	  2018-07-02                      107.0 	0.08 	                         1 	    2018-07-11 	1.154681e+09 	182187
              2018-07-16            2018-07-20 	  2018-07-16                      107.0 	0.12 	                         1 	    2018-07-25 	5.166000e+06 	182152
              2018-07-24            2018-08-03 	  2018-07-30                      107.0 	0.16 	                         1 	    2018-08-08 	6.792000e+06 	182153
...

# convertible.get_cash_flow - 获取可转债的现金流

convertible.get_cash_flow(order_book_ids, start_date=None, end_date=None)

获取可转债合约的现金流数据。

# 参数

参数 类型 说明
order_book_ids str OR str list 可转债流通场所代码
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期,默认为初始的兑付日
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期,默认则返回开始日期后续所有兑付日

# 返回

  • 返回DataFrame
字段 类型 说明
payment_date datetime 理论兑付日
payment_date_act datetime 实际兑付日
record_date datetime 债券登记日
interest_payment_pretax float 每百元面额付息(税前)
interest_payment float 每百元面额付息
principal_payment float 每百元面额兑付现金
cash_flow_pretax float 税前现金流
cash_flow float 税后现金流

# 范例

  • 获取 110032.XSHG 的现金流情况:
[In]convertible.get_cash_flow('110032.XSHG')
[Out]
 	                              record_date	cash_flow_pretax	principal_payment	interest_payment_pretax	  payment_date_act	cash_flow	interest_payment
order_book_id	payment_date
110032.XSHG	    2017-01-04	      2017-01-03	0.200	            0.0	                0.200	                  2017-01-10	    0.1600	    0.1600
                2018-01-04	      2018-01-03	0.500	            0.0	                0.500	                  2018-01-10	    0.4000	    0.4000
                2019-01-04	      2019-01-03	1.000	            0.0	                1.000	                  2019-01-10	    0.8000	    0.8000
                2019-03-20	      2019-03-19	100.304	            100.0	            0.304	                  2019-03-26	    100.2432	0.2432
...

# convertible.is_suspended - 判断可转债是否全天停牌

convertible.is_suspended(order_book_ids,start_date=None,end_date=None)

判断某只可转债或列表在一段时间内是否全天停牌

# 参数

参数 类型 说明
order_book_ids str OR str list 可转债合约代码
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期,默认为转债上市日期
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期,默认为当前日期,如果转债已经退市,则为退市日期

# 返回

  • pandas DataFrame
  • 如果在查询期间内转债尚未上市,或已退市,函数则报错提示;如果开始日期早于转债上市日期,则以转债上市日期作为开始日期

# 范例

  • 获取国轩转债从 2020 年 5 月 1 日至 2020 年 5 月 30 日的停牌情况:
[In]convertible.is_suspended('128086.XSHE',20200501,20200530)
[Out]
         128086.XSHE
2020-05-06	False
2020-05-07	False
2020-05-08	False
2020-05-11	False
2020-05-12	False
2020-05-13	False
2020-05-14	False
2020-05-15	False
2020-05-18	False
2020-05-19	False
2020-05-20	True
2020-05-21	True
2020-05-22	True
2020-05-25	True
2020-05-26	True
2020-05-27	True
2020-05-28	True
2020-05-29	False

# convertible.get_instrument_industry - 获取转债所属行业分类信息

convertible.get_instrument_industry('order_book_ids',source=None,level=1,date=None)

转债行业分类即为对应正股上市公司行业分类

  • 日期默认为当前最新,获取转债对应正股指定日期行业分类

参数

参数 类型 说明
order_book_ids str OR str list 可转债流通场所代码
date Str 行业分类指定查询日期
source str 指定行业分标准,包含 citics 以及 citics_2019: 中信, gildata: 聚源
level int 行业分类级别,共三级,默认返回一级分类。参数 0,1,2,3 一一对应,其中 0 返回三级分类完整情况

返回

字段 类型 说明
first_industry_code int 一级行业分类代码
first_industry_name str 一级行业分类名称
second_industry_code int 二级行业分类代码
second_industry_name str 二级行业分类名称
third_industry_code int 三级行业分类代码
third_industry_name str 三级行业分类名称

范例

  • 获取当前转债所对应的一级行业分类
[In]
rqdatac.convertible.get_instrument_industry('113029.XSHG')
[Out]
first_industry_code first_industry_name
order_book_id
113029.XSHG 27  电力设备
  • 获取当前转债组所对应的中信行业的全部分类:
[In]
rqdatac.convertible.get_instrument_industry(['125069.XSHE','113029.XSHG'],source='citics',level=0)
[Out]
    first_industry_code first_industry_name second_industry_code    second_industry_name    third_industry_code third_industry_name
order_book_id
125069.XSHE 42  房地产 4210    房地产开发管理 421020  商业地产
113029.XSHG 27  电力设备    2730    新能源设备   273010  风电

# convertible.get_industry - 获取指定行业分类下的转债列表

convertible.get_industry(industry,source='citics',date=None)
  • 指定日期,返回指定行业分类下该日期仍在上市状态下的转债列表;默认日期, 即返回所有转债列表

参数

参数 类型 说明
industry str 对应行业分类名称
date Str 行业分类指定查询日期
source str 指定行业分标准,包含 citics 以及 citics_2019: 中信, gildata: 聚源

返回

可转债 id 列表

范例

  • 获取指定行业分类、日期上市状态可转债 id 列表
[In]
rqdatac.convertible.get_industry(industry='电气设备',source='citics_2019',date='2020-01-26')
[Out]
['113505.XSHG',
 '113546.XSHG',
 '113549.XSHG',
 '123014.XSHE',
 '123030.XSHE',
 '123034.XSHE',
 '128018.XSHE',
 '128042.XSHE',
 '128089.XSHE']

# convertible.get_accrued_interest_eod - 获取可转债日终应计利息

convertible.get_accrued_interest_eod(order_book_ids,start_date=None,end_date=None)
  • 不指定日期, 返回近 3 个月日应计利息数据;应计利息从转债起息日起算

参数

参数 类型 说明
order_book_ids str OR str list 可转债合约代码
start_date Str 查询起始日期
end_date str 查询截止日期

返回

可转债 id 对应日期区间应计利息 pd.DataFrame

范例

  • 获取指定可转债 id 应计利息数据
[In]
rqdatac.convertible.get_accrued_interest_eod('110072.XSHG','20200805','20201101')
[Out]
            110072.XSHG
date
2020-08-18	0.000000
2020-08-19	0.000548
2020-08-20	0.001096
2020-08-21	0.001644
2020-08-22	0.002192
...	...
2020-10-28	0.038904
2020-10-29	0.039452
2020-10-30	0.040000
2020-10-31	0.040548
2020-11-01	0.041096

# convertible.get_call_announcement - 获取可转债赎回提示性公告数据

convertible.get_call_announcement(order_book_ids,start_date=None,end_date=None)
  • 查询可转债赎回提示性公告数据,包含赎回和不赎回的信息

参数

参数 类型 说明
order_book_ids str OR str list 可转债合约代码
start_date Str 查询起始日期
end_date str 查询截止日期

返回

字段 类型 说明
info_date datetime 公告日
first_info_date datetime 首次发布赎回公告日
if_call bool 是否赎回
if_issuer call bool 是否发行人赎回(True-发行人赎回,False-到期赎回)
call_price float 赎回价格(扣税,元/张)
call_price_before_tax float 赎回价格(含税,元/张)
stop_exe_start_date datetime 触发不行权区间起始日
stop_exe_end_date datetime 触发不行权区间截止日
update_time datetime 数据入库时间

范例

  • 获取指定可转债 id 赎回提示性公告数据
[In]
rqdatac.convertible.get_call_announcement('113541.XSHG')
[Out]
                                    update_time   call_price  if_call  first_info_date  stop_exe_start_date	call_price_before_tax	stop_exe_end_date
order_book_id   info_date
113541.XSHG	2021-11-23  2021-11-22 17:09:26	        NaN     False	           NaT	         2021-11-23	                  NaN	       2022-05-22
                2022-06-14  2022-06-14 00:00:00	    100.746	True	    2022-05-24	                NaT	              100.932	              NaT

# convertible.get_close_price - 获取可转债全价净价数据

convertible.get_close_price(order_book_ids,start_date=None,end_date=None,fields=None)
  • 查询可转债当日收盘价的全价和净价数据

参数

参数 类型 说明
order_book_ids str OR str list 可转债合约代码
start_date Str 查询起始日期
end_date str 查询截止日期
fields str OR str list 可输入 clean_price 或 dirty_price,默认返回全部

返回

字段 类型 说明
datetime datetime 收盘价日期
order_book_id str 可转债合约代码
clean_price float 可转债当日收盘价净价
dirty_price float 可转债当日收盘价全价

范例

  • 获取指定可转债 id 赎回提示性公告数据
[In]
rqdatac.convertible.get_close_price(['132020.XSHG','132026.XSHG'],start_date='2024-04-30', end_date='2024-04-30')
[Out]
                             clean_price  dirty_price
order_book_id	date
132020.XSHG	    2024-04-30	  110.673	  111.207247
132026.XSHG	    2024-04-30	  125.525	  125.616507

# 可转债衍生数据

# convertible.get_indicators - 获取可转债衍生指标

convertible.get_indicators(order_book_ids,start_date=None, end_date=None,fields=None)

参数

参数 类型 说明
order_book_ids str OR str list 可转债合约代码
start_date str, datetime.date, datetime.datetime, pandasTimestamp 查询开始日期
end_date str, datetime.date, datetime.datetime, pandasTimestamp 查询结束日期
fields str OR str list 选定返回列,默认返回全部

返回

字段 类型 说明 计算备注
conversion_coefficient float 转股系数 转股系数=100/转股价
conversion_value float 转股价值 转股价值=正股收盘价*转股系数
conversion_premium float 转股溢价率 转股溢价率=(转债收盘全价/转股价值-1)*100%
yield_to_maturity float 税后到期收益率 当日至到期日之间产生的税后未来现金流(到期本金为到期赎回价[1])贴现为转债当前收盘全价的贴现收益率(若该转债在当日已发布强赎公告,则该指标取值为空)
yield_to_maturity_pretax float 税前到期收益率 当日至到期日之间产生的税前未来现金流(到期本金为到期赎回价[1])贴现为转债当前收盘全价的贴现收益率(若该转债在当日已发布强赎公告,则该指标取值为空)
yield_to_put float 税后回售收益率 当日至预测回售日[2]之间产生的税后未来现金流贴现为转债当前收盘全价的贴现收益率(若该转债没有回售条款,则该指标取值为空)
yield_to_put_pretax float 税前回售收益率 当日至预测回售日[2]之间产生的税前未来现金流贴现为转债当前收盘全价的贴现收益率(若该转债没有回售条款,则该指标取值为空)
double_low_factor float 双低指标 双低指标=转债收盘全价+转股溢价率*100
call_trigger_price float 赎回触发价 赎回触发价=当期转股价*130%(无数据代表没有强赎条款)
put_trigger_price float 回售触发价 回售触发价=当期转股价*70%(无数据代表没有回售条款)
conversion_price_reset_trigger_price float 下修触发价 下修转股价触发价=当期转股价*下修触发水平(无数据代表没有下修条款)
turnover_rate float 换手率 换手率=转债当日成交额/转债剩余市值
remaining_size float 剩余规模(元) 剩余规模=未转股的转债数量*转债面值
convertible_market_cap_ratio float 转债市值占比 转债剩余市值=转债剩余规模/面值*现价
转债占比=转债剩余市值/正股总市值
pb_ratio float 市净率 当前正股总市值 / 归属母公司股东权益合计 mrq
put_qualified_days float 回售已满足天数 根据回售条款指定时间区间,统计收盘价低于回售触发价的交易日数量
call_qualified_days float 赎回已满足天数 根据赎回条款指定时间区间,统计正股收盘价高于赎回触发价的交易日数量
conversion_price_reset_qualified_days float 转股价下修已满足天数 根据下修条款指定时间区间,统计正股收盘价低于下修触发价的交易日数量
put_status float 回售条款满足状态 根据回售条款,查看收盘价低于回售触发价的交易日数量是否达到回售条件,如还未进入回售期或没有回售条款状态标为 0,如进入回售期但还没有满足回售条件的状态为 1,如满足回售条件的状态为 2
call_status float 强赎条款满足状态 根据强赎条款,查看收盘价高于赎回触发价的交易日数量是否达到强赎条件,如还未进入转股期或没有强赎条款状态为 0,如进入转股期但还没有满足赎回条件的状态为 1,如满足赎回条件但还未发强赎公告的状态标为 2,如发布了强赎公告的状态为 3
conversion_price_reset_status float 下修条款满足状态 根据转股价下修条款,查看收盘价低于下修触发价的交易日数量是否达到下修条件,如还未满足下修条件或没有下修条款状态标为 0,满足下修条件状态为 1
pure_bond_value_1 float 纯债价值 P=∑t=1nI(1+R)t+P0(1+R)tP = \sum_{t=1}^{n} \frac{I}{(1+R)^{t}} + \frac{P_0}{(1+R)^{t}}P=∑t=1n​(1+R)tI​+(1+R)tP0​​
式中 P:债券的价格;P0P_0P0​:债券面值;I:每年利息;R:市场利率或投资者要求的必要报酬率;n:付息总期数;
其中 R 选取相同评级的中债企业债即期收益率作为折现率
pure_bond_value_premium_1 float 纯债溢价率 (转债收盘全价 / 纯债价值 -1)*100%
iv float 隐含波动率 基于 BS 模型使用布伦特方法计算隐含波动率,涉及如下参数:
行权价:以可转债最新转股价为行权价
标的价格:以当日正股收盘价(不复权)为标的价格
待偿期:以当日至转债到期日为待偿期
期权价:以可转债收盘价减去纯债价值再除以转股比例为期权价
无风险利率:以一年期国债利率为无风险利率
股息率:以滚动四季度股息率估计
delta float delta 转债价格对正股股价的敏感度
theta float theta 转债价格对时间的偏导
gamma float gamma 转债价格对正股股价的二阶导
vega float vega 转债价格对隐含波动率的偏导
pure_bond_value_premium float deprecate
pure_bond_value_premium_pretax float deprecate
pure_bond_value float deprecate
pure_bond_value_pretax float deprecate

[1]到期赎回价:对于没有到期赎回价的转债,将其到期赎回价填为本金加最后一期利息
[2]预计回售日:对于还没有进入回售期的转债,预测回售日期 = 回售期开始日期 + 回售触发自然日天数(基于 window_days 推算)+ 回售资金到账所需时间(假设为 30 自然日)
对于已经进入回售期的转债,预测回售日期=计算日+ 回售触发自然日天数(基于 window_days 推算)+ 回售资金到账所需时间(假设为 30 自然日)

范例

  • 获取指定日期可转债列表衍生指标数据
[In]
rqdatac.convertible.get_indicators(['110031.XSHG','110033.XSHG'],start_date=20200803, end_date=20200803)
[Out]
		call_qualified_days	call_status	call_trigger_price	conversion_coefficient	conversion_premium	conversion_price_reset_qualified_days	conversion_price_reset_status	conversion_price_reset_trigger_price	conversion_value	convertible_market_cap_ratio	...	pure_bond_value_pretax	put_qualified_days	put_status	put_trigger_price	remaining_size	turnover_rate	yield_to_maturity	yield_to_maturity_pretax	yield_to_put	yield_to_put_pretax
order_book_id	date
110031.XSHG	2020-08-03	0	1	28.028	4.638219	0.323528	20	1	19.404	85.204082	0.070301	...	104.444003	0	1	15.092	2.398829e+09	0.007542	-0.074144	-0.059667	-0.127928	-0.126791
110033.XSHG	2020-08-03	0	1	9.347	13.908206	0.153650	7	0	6.471	98.470097	0.092509	...	105.106132	0	1	5.033	1.211731e+09	0.005133	-0.036681	-0.024483	-0.447469	-0.440123

# convertible.get_credit_rating - 获取可转债债项评级数据

convertible.get_credit_rating(order_book_ids, start_date=None, end_date=None, institutions=None)
  • 查询可转债债项评级数据 (信用评级中:SPC 标识为标普信用评级,pi 为主动评级,u 为主动评级,sf 为结构融资产品的评级)

参数

参数 类型 说明
order_book_ids str OR str list 可转债合约代码
start_date Str 查询起始日期
end_date str 查询截止日期
institutions str 不传默认输出所有评级机构。

institutions 可选项见下表:

institutions
上海新世纪资信评估投资服务有限公司
上海资信有限公司
东方金诚国际信用评估有限公司
中债资信评估有限责任公司
中国诚信信用管理股份有限公司
中证鹏元资信评估股份有限公司
中诚信国际信用评级有限责任公司
中诚信证评数据科技有限公司
云南省资信评估事务所
大公国际资信评估有限公司
大普信用评级股份有限公司
安融信用评级有限公司
惠誉博华信用评级有限公司
惠誉国际信用评级有限公司
标准普尔评级公司
标普信用评级(中国)有限公司
福建省资信评级委员会
穆迪评级公司
联合信用评级有限公司
联合资信评估股份有限公司
远东资信评估有限公司

返回

字段 类型 说明
order_book_ids str 可转债合约代码
credit_date datetime 债项评级日期
info_date datetime 公告发布日期
info_source varchar(200) 信息来源
institution str 债项评级机构
credit str 债项评级
rice_create_tm datetime 米筐入库时间

范例

  • 获取指定可转债 id 债项评级数据
[In]
rqdatac.convertible.get_credit_rating('110031.XSHE')
[Out]
                            info_date	info_source	                                            institution	         credit	   rice_create_tm
order_book_id	credit_date
110031.XSHG	    2014-08-21	2015-06-10	6-10 资信评级机构为本次发行可转换公司债券出具的资信评级报告	联合信用评级有限公司	   AAA	  2023-12-11 07:00:18
                2015-07-31	2015-08-04	航天信息2014年可转换公司债券跟踪评级分析报告	            联合信用评级有限公司     AAA	  2023-12-11 07:00:18
                2016-05-17	2016-05-18	航天信息:可转换公司债券2016年跟踪评级报告	                联合信用评级有限公司     AAA	  2023-12-11 07:00:18
                2017-05-17	2017-05-19	航天信息:关于“航信转债”跟踪信用评级结果的公告	            联合信用评级有限公司	   AAA	  2023-12-11 07:00:18
                2018-04-26	2018-04-27	航天信息可转换公司债券2018年跟踪评级报告	                联合信用评级有限公司	   AAA	  2023-12-11 07:00:18
                2019-05-24	2019-05-28	航天信息可转换公司债券2019年跟踪评级报告	                联合信用评级有限公司	   AAA	  2023-12-11 07:00:18
                2020-06-05	2020-06-10	航天信息:可转换公司债券2020年跟踪评级报告	                联合信用评级有限公司	   AAA	  2023-12-11 07:00:18
                2021-05-25	2022-02-10	航天信息股份有限公司公开发行可转换公司债券2021年跟踪评级报告 联合资信评估股份有限公司 AAA	  2023-12-11 07:00:18

# convertible.get_std_discount - 获取可转债标准劵折算率

convertible.get_std_discount(order_book_ids, start_date=None, end_date=None)
  • 查询可转债标准劵折算率

参数

参数 类型 说明
order_book_ids str OR str list 可转债合约代码
start_date str, datetime.date, datetime.datetime, pandasTimestamp 开始日期,默认为当前交易日
end_date str, datetime.date, datetime.datetime, pandasTimestamp 结束日期,默认为当前交易日

返回

字段 类型 说明
discount_factor float 标准券折算率(每百元面值折算成标准券所乘的系数)

范例

  • 获取指定可转债 id 的标准劵折算率
[In]
rqdatac.convertible.get_std_discount('110059.XSHG', start_date=20240615, end_date=20240621)
[Out]
                                discount_factor
order_book_id	    date
110059.XSHG	      2024-06-17	    0.73
                  2024-06-18	    0.73
                  2024-06-19	    0.73
                  2024-06-20	    0.73
                  2024-06-21	    0.73
Last Updated: 3/3/2025, 10:20:19 AM

← 基金 风险因子 →