Date (#4032)

* add version * add bond_cb_profile_sina
akfamily · Aug 7, 2023 · c5e9c0f · c5e9c0f
1 parent 04a73ad
commit c5e9c0f
Show file tree

Hide file tree

Showing 5 changed files with 188 additions and 1 deletion.
diff --git a/akshare/__init__.py b/akshare/__init__.py
@@ -2491,9 +2491,10 @@
 1.10.74 add: add stock_sns_sseinfo interface
 1.10.75 add: add macro_china_urban_unemployment interface
 1.10.76 fix: fix stock_notice_report interface
+1.10.77 add: add bond_cb_profile_sina interface
 """
 
-__version__ = "1.10.76"
+__version__ = "1.10.77"
 __author__ = "AKFamily"
 
 import sys
@@ -2508,6 +2509,11 @@
 
 del sys
 
+"""
+新浪财经-债券-可转债
+"""
+from akshare.bond.bond_cb_sina import bond_cb_profile_sina, bond_cb_summary_sina
+
 """
 上证e互动
 """

diff --git a/akshare/bond/bond_cb_sina.py b/akshare/bond/bond_cb_sina.py
@@ -0,0 +1,55 @@
+# -*- coding:utf-8 -*-
+# !/usr/bin/env python
+"""
+Date: 2023/8/7 20:20
+Desc: 新浪财经-债券-可转债
+https://money.finance.sina.com.cn/bond/info/sz128039.html
+"""
+import pandas as pd
+import requests
+
+
+def bond_cb_profile_sina(symbol: str = "sz128039") -> pd.DataFrame:
+    """
+    新浪财经-债券-可转债-详情资料
+    https://money.finance.sina.com.cn/bond/info/sz128039.html
+    :param symbol: 带市场标识的转债代码
+    :type symbol: str
+    :return: 可转债-详情资料
+    :rtype: pandas.DataFrame
+    """
+    url = f"https://money.finance.sina.com.cn/bond/info/{symbol}.html"
+    r = requests.get(url)
+    temp_df = pd.read_html(r.text)[0]
+    temp_df.columns = ['item', 'value']
+    return temp_df
+
+
+def bond_cb_summary_sina(symbol: str = "sh155255") -> pd.DataFrame:
+    """
+    新浪财经-债券-可转债-债券概况
+    https://money.finance.sina.com.cn/bond/quotes/sh155255.html
+    :param symbol: 带市场标识的转债代码
+    :type symbol: str
+    :return: 可转债-债券概况
+    :rtype: pandas.DataFrame
+    """
+    url = f"https://money.finance.sina.com.cn/bond/quotes/{symbol}.html"
+    r = requests.get(url)
+    temp_df = pd.read_html(r.text)[10]
+    part1 = temp_df.iloc[:, 0:2].copy()
+    part1.columns = ["item", "value"]
+    part2 = temp_df.iloc[:, 2:4].copy()
+    part2.columns = ["item", "value"]
+    part3 = temp_df.iloc[:, 4:6].copy()
+    part3.columns = ["item", "value"]
+    big_df = pd.concat([part1, part2, part3], ignore_index=True)
+    return big_df
+
+
+if __name__ == "__main__":
+    bond_cb_profile_sina_df = bond_cb_profile_sina(symbol="sz128039")
+    print(bond_cb_profile_sina_df)
+
+    bond_cb_summary_sina_df = bond_cb_summary_sina(symbol="sh155255")
+    print(bond_cb_summary_sina_df)
diff --git a/docs/changelog.md b/docs/changelog.md
@@ -63,6 +63,11 @@
 
 ## 更新说明详情
 
+1.10.77 add: add bond_cb_profile_sina interface
+
+    1. 新增 bond_cb_profile_sina 接口
+    2. 新增 bond_cb_summary_sina 接口
+
 1.10.76 fix: fix stock_notice_report interface
 
     1. 修复 stock_notice_report 接口
@@ -2725,6 +2730,8 @@
 
 ## 版本更新说明
 
+1.10.77 add: add bond_cb_profile_sina interface
+
 1.10.76 fix: fix stock_notice_report interface
 
 1.10.75 add: add macro_china_urban_unemployment interface

diff --git a/docs/data/bond/bond.md b/docs/data/bond/bond.md
@@ -650,6 +650,122 @@ print(bond_zh_hs_daily_df)
 
 ### 沪深可转债
 
+#### 可转债-详情资料
+
+接口: bond_cb_profile_sina
+
+目标地址: https://money.finance.sina.com.cn/bond/info/sz128039.html
+
+描述: 新浪财经-债券-可转债-详情资料
+
+限量: 单次返回指定 symbol 的可转债-详情资料数据
+
+输入参数
+
+| 名称     | 类型  | 描述                            |
+|--------|-----|-------------------------------|
+| symbol | str | symbol="sz128039"; 带市场标识的转债代码 |
+
+输出参数
+
+| 名称    | 类型     | 描述 |
+|-------|--------|----|
+| item  | object | -  |
+| value | object | -  |
+
+接口示例
+
+```python
+import akshare as ak
+
+bond_cb_profile_sina_df = ak.bond_cb_profile_sina(symbol="sz128039")
+print(bond_cb_profile_sina_df)
+```
+
+数据示例
+
+```
+        item                                              value
+0       债券名称                          2018年三力士股份有限公司公开发行可转换公司债券
+1       债券简称                                               三力转债
+2       债券代码                                           sz128039
+3       债券类型                                             可转换企业债
+4    债券面值（元）                                                100
+5    债券年限（年）                                                  6
+6    票面利率（%）                                                 --
+7        到期日                                         2024-06-08
+8        兑付日                                         2024-06-08
+9        摘牌日                                                 --
+10      计息方式                                               递进利率
+11      利率说明  本次发行的可转债票面利率第一年0.3%、第二年0.5%、第三年1.0%、第四年1.3%、第五...
+12      付息方式                                              周期性付息
+13      起息日期                                         2018-06-08
+14      止息日期                                         2024-06-07
+15      付息日期                                              06-08
+16     年付息次数                                                  1
+17   发行价格（元）                                                100
+18  发行规模（亿元）                                                6.2
+19      发行日期                                         2018-06-08
+20      上市日期                                         2018-06-29
+21      上市场所                                              深圳交易所
+22      信用等级                                                 A+
+23  内部信用增级方式                                                 --
+24  外部信用增级方式                                                 --
+```
+
+#### 可转债-债券概况
+
+接口: bond_cb_summary_sina
+
+目标地址: https://money.finance.sina.com.cn/bond/quotes/sh155255.html
+
+描述: 新浪财经-债券-可转债-债券概况
+
+限量: 单次返回指定 symbol 的可转债-债券概况数据
+
+输入参数
+
+| 名称     | 类型  | 描述                            |
+|--------|-----|-------------------------------|
+| symbol | str | symbol="sh155255"; 带市场标识的转债代码 |
+
+输出参数
+
+| 名称    | 类型     | 描述 |
+|-------|--------|----|
+| item  | object | -  |
+| value | object | -  |
+
+接口示例
+
+```python
+import akshare as ak
+
+bond_cb_summary_sina_df = ak.bond_cb_summary_sina(symbol="sh155255")
+print(bond_cb_summary_sina_df)
+```
+
+数据示例
+
+```
+        item       value
+0       债券类型       普通企业债
+1       计息方式        固定利率
+2       付息方式       周期性付息
+3    票面利率（%）        5.50
+4      每年付息日       03-20
+5    发行价格（元）         100
+6   发行规模（亿元）          17
+7    债券面值（元）         100
+8    债券年限（年）           5
+9       到期日期  2024-03-20
+10     全价（元）          --
+11   剩余年限（年）        0.62
+12  到期收益率（%）          --
+13      修正久期          --
+14        凸性          --
+```
+
 #### 实时行情数据
 
 接口: bond_zh_hs_cov_spot

diff --git a/docs/tutorial.md b/docs/tutorial.md
@@ -1214,6 +1214,9 @@
  "stock_irm_ans_cninfo"  # 互动易-回答
  # 上证e互动
  "stock_sns_sseinfo"  # 上证e互动-提问与回答
+ # 新浪财经-债券-可转债
+ "bond_cb_profile_sina"  # 新浪财经-债券-可转债-详情资料
+ "bond_cb_summary_sina"  # 新浪财经-债券-可转债-债券概况
 ```
 
 ## 案例演示