可转债增值数据函数(付费)

python 可转债数据 API 包含在 gm3.0.145 版本及以上版本

bnd_get_conversion_price - 查询可转债转股价变动信息

查询可转债一段时间的转股价变动和转股结果

函数原型：

bnd_get_conversion_price(symbol, start_date="", end_date="")

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbol	str	可转债代码	Y	无	必填，只能输入一个可转债的symbol
start_date	str	开始时间	N	""	开始时间日期（转股价格生效日），%Y-%m-%d 格式， 默认""表示最新时间
end_date	str	结束时间	N	""	结束时间日期（转股价格生效日），%Y-%m-%d 格式， 默认""表示最新时间

返回值：dataframe

字段名	类型	中文名称	说明
pub_date	str	公告日期	%Y-%m-%d 格式
effective_date	str	转股价格生效日期	%Y-%m-%d 格式
execution_date	str	执行日期	%Y-%m-%d 格式
conversion_price	float	转股价格	单位：元
conversion_rate	float	转股比例	单位：%
conversion_volume	float	本期转股数	单位：股
conversion_amount_total	float	累计转股金额	单位：万元，累计转债已经转为股票的金额，累计每次转股金额
bond_float_amount_remain	float	债券流通余额	单位：万元
event_type	str	事件类型	初始转股价，调整转股价，修正转股价
change_reason	str	转股价变动原因	发行，股权激励，股权分置，触发修正条款，其它变动原因，换股吸收合并， 配股，增发，上市，派息，送股，转增股，修正

示例：

bnd_get_conversion_price(symbol='SZSE.123015')

输出：

pub_date effective_date execution_date  conversion_price  conversion_rate  conversion_volume  conversion_amount_total  bond_float_amount_remain event_type change_reason
0  2022-07-29     2022-08-01     2022-08-01              2.38          42.0168                0.0                      0.0                       0.0      修正转股价     修正,触发修正条款

注意：

1. 本期转股数、累计转股金额、债券流通余额在执行日期收盘后才有数据。

2. 当start_date == end_date时，取离end_date最近转股价格生效日期的一条数据， 当start_date < end_date时，取指定时间段的数据， 当start_date > end_date时，返回报错。

bnd_get_call_info - 查询可转债赎回信息

查询可转债一段时间内的赎回情况

函数原型：

bnd_get_call_info(symbol, start_date="", end_date="")

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbol	str	可转债代码	Y	无	必填，只能输入一个可转债的symbol
start_date	str	开始时间	N	""	开始时间日期（公告日），%Y-%m-%d 格式， 默认""表示最新时间
end_date	str	结束时间	N	""	结束时间日期（公告日），%Y-%m-%d 格式， 默认""表示最新时间

返回值：dataframe

字段名	类型	中文名称	说明
pub_date	str	公告日	赎回公告日，%Y-%m-%d 格式
call_date	str	赎回日	发行人行权日（实际），%Y-%m-%d 格式
record_date	str	赎回登记日	理论登记日，%Y-%m-%d 格式
cash_date	str	赎回资金到账日	投资者赎回款到账日
call_type	str	赎回类型	部分赎回，全部赎回
call_reason	str	赎回原因	满足赎回条件，强制赎回，到期赎回
call_price	float	赎回价格	单位：元/张，每百元面值赎回价格，即债券面值加当期应计利息（含税）
interest_included	bool	是否包含利息	False-不包含，True-包含

示例：

bnd_get_call_info(symbol='SHSE.110041')

输出：

     pub_date   call_date record_date cash_date call_type call_reason  call_price  interest_included
0  2021-10-18  2021-11-05  2021-11-04      None      全部赎回        强制赎回     101.307               True

注意：

当start_date == end_date时，取离end_date最近公告日的一条数据， 当start_date < end_date时，取指定时间段的数据， 当start_date > end_date时，返回报错。

bnd_get_put_info - 查询可转债回售信息

查询可转债一段时间内的回售情况

函数原型：

bnd_get_put_info(symbol, start_date="", end_date="")

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbol	str	可转债代码	Y	无	必填，只能输入一个可转债的symbol
start_date	str	开始时间	N	""	开始时间日期（公告日），%Y-%m-%d 格式， 默认""表示最新时间
end_date	str	结束时间	N	""	结束时间日期（公告日），%Y-%m-%d 格式， 默认""表示最新时间

返回值：dataframe

字段名	类型	中文名称	说明
pub_date	str	公告日	回售公告日，%Y-%m-%d 格式
put_start_date	str	赎回日	投资者行权起始日，%Y-%m-%d 格式
put_end_date	str	赎回登记日	投资者行权截止日，%Y-%m-%d 格式
cash_date	str	赎回资金到账日	投资者回售款到账日
put_reason	str	回售原因	满足回售条款，满足附加回售条款
put_price	float	回售价格	单位：元/张，每百元面值回售价格（元），即债券面值加当期应计利息（含税）
interest_included	bool	是否包含利息	False-不包含，True-包含

示例：

bnd_get_put_info(symbol='SZSE.128015')

输出：

     pub_date put_start_date put_end_date   cash_date put_reason  put_price  interest_included
0  2022-06-09     2022-06-16   2022-06-22  2022-06-29     满足回售条款    100.039               True

注意：

当start_date == end_date时，取离end_date最近公告日的一条数据， 当start_date < end_date时，取指定时间段的数据， 当start_date > end_date时，返回报错。

bnd_get_amount_change - 查询可转债剩余规模变动

查询可转债转股、回售、赎回等事件导致的剩余规模变动的情况

函数原型：

bnd_get_amount_change(symbol, start_date="", end_date="")

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbol	str	可转债代码	Y	无	必填，只能输入一个可转债的symbol
start_date	str	开始时间	N	""	开始时间日期（变动日期），%Y-%m-%d 格式， 默认""表示最新时间
end_date	str	结束时间	N	""	结束时间日期（变动日期），%Y-%m-%d 格式， 默认""表示最新时间

返回值：dataframe

字段名	类型	中文名称	说明
pub_date	str	公告日	%Y-%m-%d 格式
change_date	str	变动日期	%Y-%m-%d 格式
change_type	str	变动类型	首发，增发，转股，赎回，回售(注销)，到期
change_amount	float	本次变动金额	单位：万元
remain_amount	float	剩余金额	变动后金额，单位：万元

示例：

bnd_get_amount_change(symbol='SZSE.123015')

输出：

     pub_date change_type change_date  change_amount  remain_amount
0  2022-10-10          转股  2022-09-30           8.91       10004.18

注意：

1. 变动类型指定为首发时，返回的剩余金额为发行金额。

2. 当start_date == end_date时，取离end_date最近变动日期的一条数据， 当start_date < end_date时，取指定时间段的数据， 当start_date > end_date时，返回报错。

bnd_get_analysis - 查询可转债分析指标

查询可转债分析指标

** , gm SDK 3.0.172 版本新增**

函数原型：

bnd_get_analysis(symbol, start_date=None, end_date=None)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
symbol	str	可转债代码	Y	无	必填，只能输入一个可转债的symbol
start_date	str	开始时间	N	None	开始时间日期，%Y-%m-%d 格式，日期类型为交易日期，默认None表示最新时间
end_date	str	结束时间	N	None	结束时间日期，%Y-%m-%d 格式，日期类型为交易日期，默认None表示最新时间

返回值：dataframe

字段名	类型	中文名称	说明
symbol	str	可转债代码	查询分析指标的可转债代码
trade_date	str	交易日期	%Y-%m-%d 格式
cnv_value	float	转股价值	平价，是指当前每100元转债转换成股票的价值。转股价值=100×当前正股价格/当前转股价格
cnv_premium	float	转股溢价	转股溢价=转债价格-转股价值
cnv_premium_rate	float	转股溢价率(%)	转股溢价率=转债价格/转股价值-1，当转股溢价率越低时，转债价格和转股价值越接近，转债股性越强，转债的价格对正股的价格波动越敏感。当转股溢价率越高时，转股债性越强。
arbitrage	float	套利空间	转股溢价率为负时的折价套利空间
cur_yield	float	当期收益率(%)	当期收益率=年息票利息/转债价格
pure_value_cb	float	纯债价值(中债基准)	债底，是指在不考虑转债提前赎回、回售或转股的情况下，将转债各期的现金流，根据同期限、同评级的企业债券到期收益率进行贴现，所得贴现值之和即为当前时点转债的纯债价值。 （中债基准）
pure_value_csi	float	纯债价值(中证基准)	债底，是指在不考虑转债提前赎回、回售或转股的情况下，将转债各期的现金流，根据同期限、同评级的企业债券到期收益率进行贴现，所得贴现值之和即为当前时点转债的纯债价值。 （中证基准）
pure_premium	float	纯债溢价	纯债溢价=转债价格-纯债价值
pure_premium_rate	float	纯债溢价率(%)	纯债溢价率=转债价格/纯债价值-1
floor_premium_rate	float	平价底价溢价率(%)	平价底价溢价率=转股价值/转债价值，根据平价底价溢价率，可将转债划分成三类风格：平价底价溢价率大于1.2为偏股型转债，介于0.8和1.2之间为混合型转债，小于0.8为偏债型转债。
cnv_dil_rate	float	转股稀释率(%)	(正股总股本+转股数量)/正股总股本
circ_dil_rate	float	对流通股稀释率(%)	(正股流通股本+转股数量)/正股流通股本

示例：

bnd_get_analysis(symbol='SHSE.118022', start_date=None, end_date=None)

输出：

        symbol                 trade_date   cnv_value  cnv_premium  \
0  SHSE.118022  2024-11-25T00:00:00+08:00  40.1802962   60.9697038   
   cnv_premium_rate   arbitrage   cur_yield  pure_value_cb  pure_value_csi  \
0      151.74030449 -60.9697038  0.98863075   103.81204257    103.58579086   
   pure_premium  pure_premium_rate  floor_premium_rate  cnv_dil_rate  \
0   -2.43579086        -2.35147199        -61.21061019    9.78546274   
   circ_dil_rate  
0     9.78546274  

注意：

1. 变动类型指定为首发时，返回的剩余金额为发行金额。

2. 当start_date == end_date时，取离end_date最近变动日期的一条数据， 当start_date < end_date时，取指定时间段的数据， 当start_date > end_date时，返回报错。

---