Tushare 可转债票面利率接口(cb_rate)实战指南:从票息结构到定价研究

发布时间:2026/10/8 13:55:55

Tushare 可转债票面利率接口(cb_rate)实战指南:从票息结构到定价研究 金融科技示例工程【免费下载链接】ai_quant_tradeStock AI Trader: 1-stop platform for learning, sim live trading. Covers: stock basics, strategies, LLMs, factor mining, ML/DL/RL, graph nets, HFT, C deploy JoinQuant code. 股票AI操盘手一站式学习、模拟、实盘平台。涵盖股票基础、策略、大模型、因子挖掘、机器学习/深度学习/强化学习、图网络、高频交易、C部署及聚宽代码。项目地址https://gitcode.com/gh_mirrors/ai/ai_quant_trade点击查看免费下载本文围绕 ai_quant_trade 仓库中 tushare 数据源 Skill 包内的《可转债票面利率》接口文档系统讲解 Tusharecb_rate接口的权限门槛、输入/输出参数、调用方法与数据落地并结合仓库中的配套脚本与可转债系列接口cb_basic、cb_daily展示如何把票面利率数据用于可转债的现金流建模、双低策略与转股价值研究。一、接口总览cb_rate 能拿到什么可转债Convertible Bond兼具债性与股性其票面利率coupon rate是刻画债性的核心变量它直接决定每期应付利息是现金流贴现、纯债价值测算的输入项。绝大多数可转债采用累进利率设计存续期内逐年递增因此票面利率不是一个单值而是一组随付息区间变化的序列。Tushare 的cb_rate接口接口 ID305分类债券专题正是为此设计提供每只转债各付息期内的票面利率明细。接口核心信息如下出自 可转债票面利率.md项目内容接口名cb_rate描述获取可转债票面利率限量单次最大 2000 条总量不限制权限用户需至少 5000 积分才可调取二、前置准备安装、Token 与 Pro 接口cb_rate属于 Tushare Pro 积分接口调用前需完成环境准备。仓库中 tushare Skill 包的 SKILL.md 给出了标准流程安装依赖推荐 Python 3.7建议使用清华 PyPI 镜像加速pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple注册并配置 Token在 Tushare 官网注册获取 token 后写入环境变量export TUSHARE_TOKENyour_token初始化 Pro 接口仓库中的 scripts/stock_data_example.py 展示了推荐的 token 读取方式——优先读环境变量缺失时回退到本地缓存 tokenimport os import tushare as ts token os.getenv(TUSHARE_TOKEN) or ts.get_token() pro ts.pro_api(token)注意仓库文档的通用格式约定见 SKILL.md 的参数格式说明日期统一为YYYYMMDD格式代码统一使用ts_code如123046.SZ、110030.SH接口返回均为 pandas DataFrame。三、输入参数详解cb_rate的入参非常简单仅一个必选参数下表取自原文档并补充取值说明名称类型必选描述ts_codestrY转债代码支持多值输入多个代码用逗号分隔关键点ts_code必须采用 Tushare 标准转债代码格式6 位数字 交易所后缀例如123046.SZ表示深交所转债、113008.SH表示上交所转债。由于支持多值输入单次调用即可批量获取多只转债的票息结构配合单次最大 2000 条的限量完全覆盖全市场存量转债的票息明细。四、输出参数详解接口返回 5 个字段下表为原文档完整参数表名称类型默认显示描述ts_codestrY转债代码rate_freqintN付息频率次/年rate_start_datestrN付息开始日期rate_end_datestrN付息结束日期coupon_ratefloatN票面利率%语义说明rate_freq年付息次数。绝大多数转债为每年付息一次rate_freq1少数品种可能为半年付息rate_freq2它是现金流时间轴的节奏参数。rate_start_date/rate_end_date当前票面利率的适用区间YYYYMMDD格式。同一只转债会按存续期拆成多行每一行对应一个票息区间这正是累进利率结构的体现。coupon_rate该区间内的年化票面利率百分数如0.500000表示 0.5%。五、接口调用示例原文档给出的标准调用方式如下pro ts.pro_api(your token) # 获取可转债基础信息列表 df pro.cb_rate(ts_code123046.SZ,127064.SZ, fieldsts_code,rate_freq,rate_start_date,rate_end_date,coupon_rate)调用要点pro即ts.pro_api(token)返回的 Pro 接口实例token 获取方式见第二节。ts_code传入多只转债123046.SZ、127064.SZ验证了多值输入能力。fields显式指定返回字段只取需要的 5 列减少网络传输不传fields时默认返回全部字段。返回结果为 pandas DataFrame可直接用df.head()、df.to_csv()等方式预览或持久化。为便于日常使用可将其封装为可复用函数参照 scripts/stock_data_example.py 的工程化写法import os import tushare as ts token os.getenv(TUSHARE_TOKEN) or ts.get_token() pro ts.pro_api(token) def get_cb_rate(ts_code): 获取可转债票面利率明细 try: df pro.cb_rate( ts_codets_code, fieldsts_code,rate_freq,rate_start_date,rate_end_date,coupon_rate ) print(f{ts_code} 票面利率获取成功共 {len(df)} 条票息区间) return df except Exception as e: print(f获取票面利率失败{e}) return None if __name__ __main__: df get_cb_rate(123046.SZ,127064.SZ) if df is not None: print(df.sort_values([ts_code, rate_start_date]))六、返回数据示例与解读原文档给出的cb_rate数据示例如下ts_code rate_freq rate_start_date rate_end_date coupon_rate 0 123046.SZ 1 20200319 20210318 0.500000 1 123046.SZ 1 20210319 20220318 0.700000 2 123046.SZ 1 20220319 20230318 1.000000 3 123046.SZ 1 20230319 20240318 1.500000 4 123046.SZ 1 20240319 20250318 2.500000 5 123046.SZ 1 20250319 20260318 3.000000 6 127064.SZ 1 20220519 20230518 0.200000 7 127064.SZ 1 20230519 20240518 0.400000 8 127064.SZ 1 20240519 20250518 0.600000 9 127064.SZ 1 20250519 20260518 1.500000 10 127064.SZ 1 20260519 20270518 1.800000 11 127064.SZ 1 20270519 20280518 2.000000从数据中可以读出几个重要事实同一转债多行输出123046.SZ在 2020-03-19 至 2026-03-18 的六年存续期内被拆成 6 行每行一个票息区间验证了票面利率为逐年累进序列的判断。累进利率结构123046.SZ的票息从 0.5%第一年逐级抬升至 3.0%第六年127064.SZ则从 0.2% 升至 2.0%。这种前低后高的设计是 A 股转债主流结构。区间连续性每行rate_end_date与下一行rate_start_date首尾相接如20200319~20210318之后紧接20210319~20220318中间无空档可直接按区间拼接成完整现金流时间轴。付息频率两例均为rate_freq1每年付息一次与多数沪深转债一致。七、应用场景票面利率如何进入可转债研究票面利率数据单独使用价值有限通常要与仓库中债券专题的其他接口联动构成完整的可转债分析链路。本 Skill 包中与票息强相关的接口还有均见 SKILL.md 数据接口列表接口文档与票息的关系cb_basic可转债基础信息提供转债面值、发行期限、利率类型、rate_clause利率说明、到期赎回价格等与cb_rate的票息序列互补可拼出完整债底结构cb_daily可转债行情提供收盘价、纯债价值bond_value、纯债溢价率bond_over_rate、转股价值、转股溢价率等行情指标典型研究路径包括现金流贴现 / 纯债价值测算以cb_rate的票息序列 cb_basic的面值、期限、到期赎回价按rate_freq的付息节奏贴现得到理论债底再与cb_daily的bond_value相互校验。双低策略构建双低 低价 低转股溢价率。其中低价的判断离不开债底支撑而债底又由票息决定——cb_rate正是该链条的起点。持有收益预判转债持有一年以上的策略需要预判未来各期的利息收入累进票息结构直接影响持有期回报预期尤其对临近回售/到期条款的转债票息与赎回条款cb_basic的maturity_put_price共同决定到期收益。调用时可参考本包内其他可转债接口的入参习惯cb_basic支持按ts_code、list_date、exchange过滤cb_daily支持按trade_date/start_date/end_date提取——先用cb_basic拿到全市场转债代码池再批量喂给cb_rate逐只拉取票息结构是兼顾限量与效率的推荐组合。八、注意事项与限制权限门槛cb_rate需要至少 5000 积分门槛高于cb_basic2000 积分与cb_daily2000 积分属于进阶数据接口积分不足时调用会报权限错误需按官方积分获取办法升级。限量与分批单次最大返回 2000 条。一只 6 年期转债约产生 6 行记录全市场存量转债不过数百只通常单次即可取完若自建历史转债全集含已退市品种超出限量时需按代码分批循环提取。数据范围接口返回的是各付息区间内的约定票面利率不含补偿利率cb_basic的add_rate字段单独提供及回售价差做到期收益测算时需叠加cb_basic的补偿利率与到期赎回条款。日期格式rate_start_date、rate_end_date为YYYYMMDD字符串需要做日期运算如计算剩余付息次数时请先pd.to_datetime()转换。九、小结cb_rate是 Tushare 债券专题中定位精准、结构清晰的数据接口入参仅需转债代码输出即完整的票息分期序列。掌握它之后配合仓库内 SKILL.md 的安装与鉴权流程、scripts/stock_data_example.py 的工程化调用范式以及cb_basic/cb_daily的联动数据即可搭建从票息现金流 → 债底估值 → 转债行情的完整可转债研究数据底座。赞分享金融科技示例工程【免费下载链接】ai_quant_tradeStock AI Trader: 1-stop platform for learning, sim live trading. Covers: stock basics, strategies, LLMs, factor mining, ML/DL/RL, graph nets, HFT, C deploy JoinQuant code. 股票AI操盘手一站式学习、模拟、实盘平台。涵盖股票基础、策略、大模型、因子挖掘、机器学习/深度学习/强化学习、图网络、高频交易、C部署及聚宽代码。项目地址https://gitcode.com/gh_mirrors/ai/ai_quant_trade点击查看免费下载相关推荐Tushare 可转债行情接口 cb_daily 实战指南从参数表到纯债/转股价值因子落地Tushare 可转债行情接口 cb_daily 实战指南从参数表到纯债/转股价值因子落地 导读 本文以开源仓库 tushare Skill 包 https:金融科技示例工程基于 Tushare cb_basic 接口的可转债基础信息获取与实战指南基于 Tushare cb_basic 接口的可转债基础信息获取与实战指南 本篇技术指南围绕 Tushare 债券专题核心接口 cb_basic 展开完整讲解金融科技示例工程Tushare 可转债转股价变动接口 cb_price_chg 实战解析从初始定价到下修博弈的数据获取与策略应用ai_quant_tradeTushare 可转债转股价变动接口 cb_price_chg 实战解析从初始定价到下修博弈的数据获取与策略应用ai_quant_trade 导读 本文围金融科技示例工程上一篇3步打造专业级智能家居控制中心如何用HASS配置实现家庭自动化革命下一篇【亲测免费】 PhotoGIMP 项目教程创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/8 13:50:54

Qt+C++模拟经营游戏源码:毕设级实战项目解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/8 13:50:54

WHOIS协议源码解析:从TCP连接到TLD路由的完整实现

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/8 13:50:54

BERT+BiLSTM+CRF在医疗NER中的实战应用与知识图谱构建

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/8 15:01:20

Tessent PDL实战:DFT测试流程与MBIST/SSN应用

任何一个用Tessent做过DFT项目的工程师,大概都有这样的经历:打开Tessent的文档,最先记住的是MBIST、SSN、Scan这些大块头关键词,可真正到了生成测试向量、调试覆盖率的阶段,几乎所有流程都会回到同一个载体——PDL。PD…

2026/10/8 15:01:20

Java实现微信iPad协议:长连接保活与断线重连实战

做IM开发的朋友,大概率听过“微信iPad协议”这个词。简单说,它就是让程序以iPad端微信客户端的身份接入微信服务端,实现消息收发、联系人同步、群聊管理等功能的一套非官方通信协议。很多企业用它做客服聚合、消息备份、自动化通知&#xff0…

2026/10/8 15:01:20

Tessent PDL核心解析:从MBIST到SSN的工程实战指南

做DFT这么多年,工具链里接触最多的就是Tessent这套东西。早年间用Tessent的时候,打交道最多的是各种测试协议、pattern文件、诊断log,说实话PDL(Procedural Description Language)一直是个让我又爱又恨的角色——爱的是…

2026/10/8 15:01:20

n8n节点类型全解析:从触发器到流程控制,构建高效自动化工作流

最近半年我一直在用 n8n 帮团队搭各种自动化流程,从客户通知、数据同步到运维告警。接触下来最大的感受是:n8n 真正把"工作流自动化"的门槛压得很低,但前提是你能理解它的核心抽象——节点类型。节点决定了一个工作流能做什么、不能…

2026/10/8 14:56:18

Windows文件服务器共享文件夹防删除:权限设计与备份兜底实践

1. 文件是怎么在共享里没了的:先认清“删除”的几种来源文件服务器上的共享文件夹被删,是我这些年在一线运维里碰到最多的“事故”,没有之一。你可能在半夜接到同事电话,说明天要给客户演示的资料全没了;也可能在周一早…

2026/10/8 10:03:18

Jev+Agent接管浏览器:browser-use实战与jev-ultrafast性能优化

1. 从“Jev”说起:为什么我要把Agent接进浏览器“Jev”这个词最近在圈子里出现的频率越来越高,很多人第一次听到会以为是某个新模型的名字,其实它更像是一种思路——把Jev模型的能力当作底座,通过Agent的方式去接管浏览器&#xf…

2026/10/8 10:03:20

多智能体集群实战:DeepAgents编排、MCP与A2A协议及Skills体系

1. 从"单兵作战"到"集群协同":多智能体编排到底在解决什么问题如果你最近在折腾 Agent 相关的东西,大概率会有一种感觉:单个 Agent 能做的事情,其实很快就摸到天花板了。你给它一个提示词,挂几个工…

2026/10/8 6:05:44

无源低通滤波器设计实战:从RC到LC,手把手教你避开那些坑

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/8 0:02:17

自然数立方等于连续奇数之和:从证明到编程验证

十几年来我一直游走在数学科普和编程教学这两块内容之间,对“看起来像魔法、拆开全是数学”的结论总是格外敏感。最近翻资料时又撞见一句话:任何一个自然数 m 的立方,都可以写成 m 个连续奇数之和。2 的立方等于 3 加 5,3 的立方等…

2026/10/8 0:02:17

C#上位机SSH连接实战:用SSH.NET补齐超时、批量与密钥认证

简介:这是一份基于 C# 开发的 SSH 连接功能半成品工程,原本作为另一个主项目的子功能模块,现独立打包分享。工程采用 WinForms 界面,包含源码、解决方案、安装部署工程、NuGet 依赖包及说明文档,适合正在做远程连接、网…

2026/10/8 0:02:17

Java SpringBoot一体化智能售后系统设计与实现全解析

毕业设计年年做,Java Web 方向的题目翻来覆去就那么几个,但“一体化智能售后系统”这个题,每次看到我都觉得值得认真聊一聊。它不是一个简单 curd 堆出来的管理系统,而是把客户、工单、派单、处理、回访、统计整条链路串起来的一套…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑