债券相关数据

查询转股条款

get_cbond_conversion-查询转股条款

查询可转债的转股条款信息。

函数原型

get_cbond_conversion(security, start_date=None, end_date=None)

参数详情

参数名	类型	必选	含义与取值说明
security	str	是	可转债代码，只能输入一个可转债的security
start_date	str	否	开始时间日期，%Y-%m-%d 格式，日期类型为交易日期，默认None表示最新时间
end_date	str	否	结束时间日期，%Y-%m-%d 格式，日期类型为交易日期，默认None表示最新时间

返回值说明

返回一个DataFrame，包含以下列：

字段名	类型	字段说明
trans_code	str	转股代码
trans_name	str	转股简称
trans_price	float	转股价格（元）
trans_price_adj_date	int	转股价格调整日
trans_ratio	float	转股比例（%）
trans_start_date	int	转股起始日期
trans_end_date	int	转股结束日期
trans_period_months	float	相对转股期（月）
is_forced_trans	int	是否强制转股
forced_trans_date	int	强制转股日
forced_trans_price	float	强制转股价格（元）
un_trans_balance	float	未转股余额（元）
un_trans_ratio	float	未转股比例（%）
price_adj_with_div	float	转股价格随派息调整

完整示例

data = get_cbond_conversion('sh118022')
log.info(data)

查询可转债分析指标

get_cbond_analysis-查询可转债分析指标

查询可转债的分析指标数据。

函数原型

get_cbond_analysis(security, start_date=None, end_date=None)

参数详情

参数名	类型	必选	含义与取值说明
security	str	是	可转债代码，只能输入一个可转债的security
start_date	str	否	开始时间日期，%Y-%m-%d 格式，日期类型为交易日期，默认None表示最新时间
end_date	str	否	结束时间日期，%Y-%m-%d 格式，日期类型为交易日期，默认None表示最新时间

返回值说明

返回一个DataFrame，包含以下列：

字段名	类型	字段说明
security	str	可转债代码
date	str	日期，%Y%m%d 格式
full_price	float	收盘全价
remain_years	float	剩余期限（年）
accrued_interest	float	应计利息
accrued_days	float	已计息天数
current_yield	float	当期收益率%
ytm	float	纯债到期收益率%
pure_bond_value	float	纯债价值
pure_bond_premium	float	纯债溢价
pure_bond_premium_ratio	float	纯债溢价率
conv_price	float	转股价
conv_ratio	float	转股比例
conv_value	float	转股价值
conv_premium	float	转股溢价
conv_premium_ratio	float	转股溢价率%
parity_premium_ratio	float	平价底价溢价率

完整示例

# 查询可转债分析指标
data = get_cbond_analysis(security='sh118022', start_date=None, end_date=None)
log.info(data)
# 输出：
#        security                 trade_date  cnv_value  cnv_premium  \
# 0  sh118022  2024-11-25T00:00:00+08:00   40.18030    60.969704   
# 
#    cnv_premium_rate   arbitrage  cur_yield  pure_value_cb  pure_value_csi  
# 0        151.740304  -60.969704   0.988631     103.812043      103.585791  
# 
#    pure_premium  pure_premium_rate  floor_premium_rate  cnv_dil_rate  
# 0     -2.435791          -2.351472          -61.210610      9.785463  
# 
#    circ_dil_rate
# 0       9.785463

ℹ️ 日期参数说明

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