AKShare 可转债比价表接口优化解析

在金融数据获取领域，AKShare 作为一款优秀的开源工具，为量化投资者和数据分析师提供了便捷的数据接口。本文针对 AKShare 中获取可转债比价表数据的接口进行了深入分析和优化。

问题背景

原接口 bond_cov_comparison() 设计用于从东方财富网获取可转债比价数据，但存在一个明显的局限性：每次调用仅返回200条数据记录。对于需要完整数据集的研究者而言，这显然不能满足需求。

技术分析

通过分析东方财富网的API接口，我们发现其采用了分页机制。原始实现仅获取了第一页数据，而完整数据需要遍历所有分页。以下是关键的技术要点：

1. 分页参数解析：

   • pn 参数表示当前页码
   • pz 参数表示每页记录数（固定为200）
   • total 字段表示总记录数

2. 数据获取流程：

   • 首先获取第一页数据并解析总记录数
   • 计算总页数：总页数 = ceil(总记录数/每页记录数)
   • 使用循环依次获取后续页面的数据

3. 性能优化：

   • 添加了进度条显示（tqdm）
   • 设置了合理的请求超时时间（15秒）
   • 采用列表暂存分页数据，最后统一合并

优化实现

优化后的实现主要改进了以下几个方面：

def bond_cov_comparison() -> pd.DataFrame:
    url = "https://16.push2.eastmoney.com/api/qt/clist/get"
    params = {
        "pn": "1",
        "pz": "200",
        # 其他必要参数...
    }
    
    # 获取第一页数据并计算总页数
    r = requests.get(url, params=params)
    data_json = r.json()
    total_page = math.ceil(data_json["data"]["total"] / 200)
    
    # 收集所有分页数据
    temp_list = []
    temp_list.append(pd.DataFrame(data_json["data"]["diff"]))
    
    # 使用进度条获取剩余页数据
    tqdm = get_tqdm()
    for page in tqdm(range(2, total_page + 1), leave=False):
        params.update({"pn": page})
        r = requests.get(url, params=params, timeout=15)
        data_json = r.json()
        inner_temp_df = pd.DataFrame(data_json["data"]["diff"])
        temp_list.append(inner_temp_df)
    
    # 合并所有数据并处理列名
    temp_df = pd.concat(temp_list, ignore_index=True)
    # 列名处理和数据筛选...
    
    return temp_df

数据字段说明

优化后的接口返回以下关键字段：

1. 转债信息：

   • 转债代码、名称
   • 最新价和涨跌幅
   • 上市日期和申购日期

2. 正股信息：

   • 正股代码、名称
   • 最新价和涨跌幅

3. 转股相关指标：

   • 转股价和转股价值
   • 转股溢价率和纯债溢价率
   • 回售触发价和强赎触发价

4. 其他关键数据：

   • 到期赎回价
   • 纯债价值
   • 开始转股日

应用价值

完整的可转债比价数据对于以下分析场景尤为重要：

1. 套利策略开发：通过完整的转股溢价率数据寻找套利机会
2. 风险评估：分析所有可转债的强赎和回售条款
3. 市场监控：全面把握可转债市场的整体表现
4. 组合构建：基于完整数据集构建可转债投资组合

总结

通过对 AKShare 可转债比价表接口的优化，我们实现了完整数据集的获取能力。这一改进不仅解决了数据不全的问题，还为量化研究和投资分析提供了更可靠的数据基础。这种分页处理的方法也可以应用于其他类似接口的优化中，具有很好的借鉴意义。

对于金融数据开发者而言，理解并掌握这种分页数据获取技术，能够显著提升数据采集的完整性和可靠性，为后续的分析工作打下坚实基础。