)
金融科技示例工程【免费下载链接】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 包所收录的「可转债转股价变动」接口文档系统讲解cb_price_chg的接口定位、输入输出参数、限量权限、调用示例与返回数据解读并联动仓库内cb_basic基础信息、cb_share转股结果、cb_call赎回信息等配套接口说明如何用转股价变动数据构建可转债事件驱动研究。读者读完本文后将能够独立完成转股价变动的数据提取、字段理解与策略落地。一、转股价变动可转债研究的核心变量可转债兼具债性与股性其股性强弱直接由转股价决定。转股价是每张面值 100 元的可转债可转换正股的价格基准由此可推导出两个最关键的投资指标转股价值转换价值 债券面值 ÷ 转股价 × 正股市价转股溢价率 转债市价 ÷ 转股价值 − 1× 100%。当上市公司发生分红送股、配股、增发等股本变动或触发募集说明书中的特别向下修正条款即下修时转股价会发生调整。每一次调整都会改变转债的转股价值与溢价率进而影响转债价格中枢与套利空间。因此转股价的历史变动记录是可转债研究中最基础也最容易被忽略的底层数据之一。在 ai_quant_trade 仓库的 Tushare Skill 包 中债券专题收录了完整的可转债数据接口族其中 可转债转股价变动 正是专门用于追踪这一变量的接口文档。二、cb_price_chg 接口总览根据仓库内 可转债转股价变动.md 的记载接口核心信息如下项目说明接口名称cb_price_chg功能描述获取可转债转股价变动数据限量单次最大 2000 条总量不限制权限要求需单独开通本接口权限与积分无关在 SKILL.md 的接口列表中cb_price_chg对应 ID 246归属债券专题分类。需要特别注意的是该接口权限是独立开通的并不随积分体系自动解锁文档中明确注明本接口需单独开权限跟积分没关系。三、输入参数详解cb_price_chg的输入参数仅有一个调用非常简单名称类型必选描述ts_codestrY转债代码支持多值输入必选参数ts_code为必传项不传将无法取数多值输入支持一次性传入多只转债代码多个代码之间使用英文逗号分隔代码格式遵循 Tushare 统一的ts_code格式即6 位数字 交易所后缀如113556.SH沪市转债、128114.SZ深市转债。可对照 可转债基础信息 中cb_basic返回的ts_code字段确认代码格式。四、输出参数详解接口返回 6 个字段覆盖了从初始定价到历次修正的完整信息名称类型默认显示描述ts_codestrY转债代码bond_short_namestrY转债简称publish_datestrY公告日期change_datestrY变动日期convert_price_initialfloatY初始转股价格convertprice_beffloatY修正前转股价格convertprice_aftfloatY修正后转股价格对字段的深度理解publish_date公告日期与 change_date变动日期是两条时间线公告日期是上市公司披露转股价调整公告的日期变动日期是转股价实际生效的日期。实际应用中公告日往往早于变动日分析事件驱动策略时应以publish_date作为信号触发点、以change_date作为价格基准切换点convert_price_initial初始转股价格是转债发行时确定的转股价在整个转债存续期内保持不变可作为对照基准convertprice_bef修正前/ convertprice_aft修正后记录每一次转股价调整的前值→后值。五、接口示例与返回数据解读文档给出的标准调用方式如下pro ts.pro_api(your token) # 获取可转债转股价变动 df pro.cb_price_chg( ts_code113556.SH,128114.SZ,128110.SZ, fieldsts_code,bond_short_name,change_date,convert_price_initial,convertprice_bef,convertprice_aft )要点说明pro实例通过ts.pro_api(token)初始化token 可参考 SKILL.md 快速上手 中的方式从环境变量TUSHARE_TOKEN或本地ts.get_token()读取fields参数用于按需选择输出列减少返回体量文档示例选取了 6 个字段中最核心的 5 个省略publish_date返回结果为 pandas DataFrame这是 Tushare 全系接口的统一返回格式。文档附带的数据示例如下ts_code bond_short_name change_date convert_price_initial convertprice_bef convertprice_aft 0 113556.SH 至纯转债 20191220 29.4700 None None 1 113556.SH 至纯转债 20200629 29.4700 29.4700 29.3800 2 128110.SZ 永兴转债 20200609 17.1600 None None 3 128114.SZ 正邦转债 20200617 16.0900 None None从这份示例数据可以清晰看出两类记录形态初始定价记录当convertprice_bef与convertprice_aft均为None时表示该条记录是转债发行时的初始转股价确立如至纯转债 20191220 确立初始转股价 29.47 元永兴转债 17.16 元、正邦转债 16.09 元转股价修正记录当两者均有数值时表示发生了一次实际的转股价调整如至纯转债 20200629 由 29.47 元修正至 29.38 元。因此在清洗数据时可以依据修正前后是否为空来区分初始定价与后续调整事件这一点是使用该接口构建事件列表的关键。六、联动仓库配套接口构建可转债研究数据体系单看cb_price_chg只是获取一条变动流水要发挥其价值需要与仓库内其他可转债接口配合。债券专题目录a_全网优秀资源/10_大模型/07_skill包/vibe_trading_skills/tushare/references/债券专题中可用的接口包括接口用途与本接口的关联cb_basic 可转债基础信息转债基础信息含first_conv_price初始转股价、conv_price最新转股价、reset_clause特别向下修正条款可交叉校验cb_price_chg的初始价格与最新价格是否与基础信息一致reset_clause文本可用于判定该转债是否具备下修条款cb_share 可转债转股结果每次转股的金额、数量、比例及累计数据输出convert_price_initial初始转换价格、convert_price本次转换价格转股价格与转股进度acc_convert_ratio累计转股比例相互印证判断转股价调整后的转股推进速度cb_call 可转债赎回信息到期赎回、强制赎回信息is_call区分公告强赎/不强赎等状态强赎往往伴随转股价 vs 正股价条件如 130% 触发线需结合转股价判断强赎是否临近可转债行情cb_daily转债日行情计算转股价值、转股溢价率需要行情 × 转股价联动上述组合可形成一条完整的可转债事件研究链路用cb_basic锁定标的池 → 用cb_price_chg定位转股价调整事件 → 用cb_daily计算事件前后溢价率变化 → 用cb_share/cb_call验证转股与强赎进展。七、实战应用场景1. 下修博弈事件驱动拥有向下修正条款的转债在正股持续低迷、触发下修条件时上市公司可能公告下调转股价以促进转股。cb_price_chg提供的正是修正前→修正后的精确记录。结合 cb_basic 的reset_clause字段筛选具备下修条款的标的再过滤convertprice_bef非空的记录即可得到历史上全部下修事件样本用于研究下修公告后的价格反应。2. 动态转股溢价率因子计算任意时点的转股溢价率必须使用当时生效的转股价而非最新价或初始价。利用cb_price_chg的change_date与修正后价格可以构建日期 → 生效转股价的映射表再与cb_daily行情对齐从而生成无未来函数的转股溢价率因子序列——这正是仓库 ai_notes/10_坑点汇总/01_数据处理 中所强调的避免引入未来信息在转债场景下的具体体现。3. 强赎与转股进度监控转股价向下修正会同步拉低强赎触发阈值如正股价达到转股价的 130%同时放大转股价值。将cb_price_chg的变动时间线与 cb_call 的强赎公告、cb_share 的累计转股比例合并可以判断一只转债下修 → 转股 → 触发强赎的完整生命周期所处阶段为持仓管理与止盈提供依据。八、可复用的完整调用脚本参照仓库 scripts/stock_data_example.py 中环境变量读取 token 封装函数 异常处理的写法可将cb_price_chg封装为如下可直接运行的脚本#!/usr/bin/env python3 # -*- coding: utf-8 -*- 可转债转股价变动数据获取示例基于 tushare cb_price_chg 接口 import os import tushare as ts # 读取环境变量中的token, 或者读取本地记录的token token os.getenv(TUSHARE_TOKEN) or ts.get_token() # 初始化pro接口 pro ts.pro_api(token) def get_cb_price_chg(ts_code): 获取可转债转股价变动 :param ts_code: 转债代码支持多值输入如 113556.SH,128114.SZ,128110.SZ try: data pro.cb_price_chg( ts_codets_code, fieldsts_code,bond_short_name,publish_date,change_date, convert_price_initial,convertprice_bef,convertprice_aft ) print(f{ts_code} 转股价变动数据获取成功共 {len(data)} 条) print(data.head()) return data except Exception as e: print(f获取转股价变动数据失败{e}) return None def extract_change_events(df): 从转股价变动数据中提取实际修正事件排除初始定价记录 推断依据初始定价记录中 convertprice_bef / convertprice_aft 均为 None if df is None or df.empty: return None events df.dropna(subset[convertprice_bef, convertprice_aft]).copy() events[change_pct] (events[convertprice_aft] / events[convertprice_bef] - 1) * 100 return events if __name__ __main__: # 获取多只转债的转股价变动 raw get_cb_price_chg(113556.SH,128114.SZ,128110.SZ) # 过滤出真实发生的修正事件并计算修正幅度 change_events extract_change_events(raw) if change_events is not None: print(\n实际转股价修正事件) print(change_events[[ts_code, bond_short_name, change_date, convertprice_bef, convertprice_aft, change_pct]])脚本中的extract_change_events依据数据示例中初始定价记录修正前/后为 None的形态规律自动剔除初始定价流水、只保留真实的转股价修正事件并额外计算修正幅度百分比可直接用于下修事件样本库的构建。九、使用注意事项权限需单独开通cb_price_chg不随积分自动解锁文档明确标注本接口需单独开权限跟积分没关系调用前需先完成权限申请否则会返回权限不足类错误限量与取数策略单次最大返回 2000 条总量不限制。对于全市场转债的批量取数可按照转债代码逐个或分批多值循环调用并按change_date排序后增量存储规避单次上限必选参数ts_code为必填项无法像部分接口那样按日期区间全量拉取取数前需先通过cb_basic拿到转债代码列表作为入参来源多值输入上限支持多值输入但一次性传入过多代码可能触发单次限量建议按 2000 条返回量倒推每批代码数量分批次请求字段命名注意convertprice_bef/convertprice_aft与convert_price_initial的命名风格不一致前者无下划线分隔在编写字段引用时需按文档原样书写避免拼写错误导致取不到列。十、小结cb_price_chg是 Tushare 债券专题中定位精准、结构简洁的转股价变动流水接口单参数入参、6 字段输出却串联起可转债定价、下修博弈、强赎监控等多项核心研究。结合 ai_quant_trade 仓库中 Tushare Skill 包 的完整接口列表与 债券专题 的配套文档读者可以将该接口无缝嵌入自有可转债数据管线构建从转股价变动事件提取到溢价率因子与事件策略的完整研究链路。赞分享金融科技示例工程【免费下载链接】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点击查看免费下载相关推荐Vibe-Trading 可转债数据接入指南使用 Tushare cb_issue 接口获取可转债发行数据Vibe Trading 可转债数据接入指南使用 Tushare cb_issue 接口获取可转债发行数据 本文是一份面向 Vibe Trading 仓库内人工智能AI Agent金融科技MCP 服务YouTube.js 专辑解析类 Album 深度指南从 InnerTube 响应到可用的专辑数据YouTube.js 专辑解析类 Album 深度指南从 InnerTube 响应到可用的专辑数据 本篇技术指南聚焦 YouTube.js 中面向 YouTu金融科技示例工程为 Rustlings 创建社区练习从 rustlings dev 模板生成到发布分享的完整实战指南为 Rustlings 创建社区练习从 rustlings dev 模板生成到发布分享的完整实战指南 Rustlings 官方在仓库中提供了一套完整的社区练习金融科技示例工程上一篇IoT-For-Beginners 实战使用 Wio Terminal 通过 MQTT 发布光照遥测数据下一篇Spree 第三方价格与库存集成ERP/PIM/DAM 身份映射与 Provider 扩展架构创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考