使用 Tushare cb_issue 接口获取可转债发行数据:参数详解与实战指南

发布时间:2026/10/8 1:36:57
使用 Tushare cb_issue 接口获取可转债发行数据:参数详解与实战指南 金融科技示例工程【免费下载链接】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_issue接口对应文档 可转债发行.md完整讲解其输入参数、30 个输出字段、调用示例与数据样例并结合同目录下的可转债基础信息cb_basic、行情cb_daily、赎回cb_call等接口给出从发行到上市到存续的可转债全生命周期数据组装思路。读完本文你将能独立通过 Tushare Pro 拉取任意时间段的可转债发行明细并理解网上申购、老股东配售、网下发行三大渠道的字段含义。一、接口概览cb_issue 能提供什么cb_issue可转债发行是 Tushare 债券专题下的核心接口用于获取沪深市场可转债的发行数据覆盖从发行公告日ann_date到发行结果公告日res_ann_date的全过程信息历史数据可追溯至上世纪 90 年代末数据示例中最早可见125009.SZ等 19982000 年发行的老券。在调用该接口前需要注意两条硬性约束单次限量单次调用最大返回 2000 条记录可多次提取总量不限制——即需要通过设置start_date/end_date或ann_date分片循环拉取全量数据积分门槛用户至少需要 2000 积分方可调取5000 积分以上频次相对较高积分越多权限越大积分获取方式详见 Tushare 官方积分文档本文不赘述外部链接。接口在 Tushare skill 包中的完整说明位于 可转债发行.md在 SKILL.md 的接口清单中对应 ID 186分类为债券专题。二、输入参数详解cb_issue共支持 4 个输入参数全部可选必选列均为 N按需组合即可名称类型必选描述ts_codestrNTS代码ann_datestrN发行公告日start_datestrN公告开始日期end_datestrN公告结束日期参数使用要点ts_code单只转债代码格式如110072.SH沪市或128125.SZ深市。不传则返回符合日期条件的所有转债ann_date / start_date / end_date日期均采用YYYYMMDD格式如20190612这是 Tushare 全系接口统一的日期规范参见 SKILL.md 中的参数格式说明实际使用中由于单次上限 2000 条建议总是配合日期范围查询按公告日分段循环抓取避免因单次返回量超限导致数据缺失。三、输出参数详解30 个字段接口默认显示 28 个字段issue_cost、onl_winning_rate等个别字段默认不显示完整输出参数如下表按逻辑可划分为四组发行基础信息、网上发行、老股东配售、网下发行。名称类型默认显示描述ts_codestrY转债代码ann_datestrY发行公告日res_ann_datestrY发行结果公告日plan_issue_sizefloatY计划发行总额元issue_sizefloatY发行总额元issue_pricefloatY发行价格issue_typestrY发行方式issue_costfloatN发行费用元onl_codestrY网上申购代码onl_namestrY网上申购简称onl_datestrY网上发行日期onl_sizefloatY网上发行总额张onl_pch_volfloatY网上发行有效申购数量张onl_pch_numintY网上发行有效申购户数onl_pch_excessfloatY网上发行超额认购倍数onl_winning_ratefloatN网上发行中签率%shd_ration_codestrY老股东配售代码shd_ration_namestrY老股东配售简称shd_ration_datestrY老股东配售日shd_ration_record_datestrY老股东配售股权登记日shd_ration_pay_datestrY老股东配售缴款日shd_ration_pricefloatY老股东配售价格shd_ration_ratiofloatY老股东配售比例shd_ration_sizefloatY老股东配售数量张shd_ration_volfloatN老股东配售有效申购数量张shd_ration_numintN老股东配售有效申购户数shd_ration_excessfloatN老股东配售超额认购倍数offl_sizefloatY网下发行总额张offl_depositfloatN网下发行定金比例%offl_pch_volfloatN网下发行有效申购数量张offl_pch_numintN网下发行有效申购户数offl_pch_excessfloatN网下发行超额认购倍数offl_winning_ratefloatN网下发行中签率lead_underwriterstrN主承销商lead_underwriter_volfloatN主承销商包销数量张字段解读要点发行基础信息组plan_issue_sizeissue_type用于判断发行规模与方式。plan_issue_size与issue_size的差异可反映实际发行是否足额issue_type标识发行方式如配售/申购等组合方式网上发行组onl_*对应普通投资者参与的打新环节。核心指标是onl_pch_excess超额认购倍数与onl_winning_rate中签率——超额认购倍数越高、中签率越低说明申购越火爆老股东配售组shd_ration_*对应原股东优先配售环节shd_ration_ratio为配售比例shd_ration_record_date股权登记日决定了享有配售权的股东名册截点网下发行组offl_*对应机构网下申购环节offl_deposit为网下发行定金比例是衡量参与门槛的重要指标承销信息lead_underwriter/lead_underwriter_vol主承销商及其包销数量可用于研究承销商在发行中的兜底力度。四、接口调用示例以下为仓库文档中给出的标准调用方式完整代码见 可转债发行.mdpro ts.pro_api() # 获取可转债发行数据按发行公告日 df pro.cb_issue(ann_date20190612) # 获取可转债发行数据自定义字段 df pro.cb_issue(fieldsts_code,ann_date,issue_size)调用前的准备流程依据 SKILL.md 的快速上手章节# 安装 tushare推荐从清华 pypi 镜像安装 pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple# 注册 Tushare 官网账号获取 token并配置环境变量 export TUSHARE_TOKENyour_tokenimport os import tushare as ts # 读取环境变量中的 token或读取本地记录的 token token os.getenv(TUSHARE_TOKEN) or ts.get_token() # 初始化 pro 接口实例 pro ts.pro_api(token) # 获取可转债发行数据 df pro.cb_issue(ann_date20190612) print(df)需要注意ts.pro_api()若不显式传入 token会尝试读取本地配置显式传入环境变量 token 的方式更利于在脚本、定时任务中复用仓库中 股票数据获取示例 与 基金数据获取示例 也遵循同样的初始化模式。五、返回数据示例解读以fieldsts_code,ann_date,issue_size提取时的数据样例如下节选自仓库文档ts_code ann_date issue_size 0 110072.SH 20200814 33.7000 1 113600.SH 20200811 5.9500 2 113598.SH 20200729 3.3000 3 113038.SH 20200729 50.0000 4 128125.SZ 20200728 4.5000 .. ... ... ... 489 100009.SH 20000223 13.5000 490 125302.SZ 19990727 15.0000 491 125301.SZ 19980826 2.0000 492 100001.SH 19980730 1.5000 493 125009.SZ None 5.0000样例要点单位确认issue_size单位为元文档字段描述明确标注示例中 33.7 对应 33.7 元/张 × 发行张数口径下的总规模实际应用时需与面值通常 100 元换算为发行张数代码后缀.SH与.SZ分别标识沪市与深市转债与可转债行情接口cb_daily的代码体系一致缺失值样例末行ann_date为None说明早期老券1998 年发行存在公告日缺失的情况做数据清洗时需预留缺失值处理逻辑。六、仓库内的扩展构建可转债全生命周期数据集cb_issue只覆盖发行这一阶段要把它真正用起来需要与 Tushare 债券专题下的其他可转债接口组合。这些接口在仓库中均有独立文档位于同一目录 债券专题 下接口文档用途cb_issue可转债发行.md发行环节公告日、发行规模、三大申购渠道数据cb_basic可转债基础信息.md基础要素转股价、利率、期限、评级、条款可与发行数据以ts_code关联cb_daily可转债行情.md上市后行情OHLCV 及纯债价值、转股价值、溢价率cb_call可转债赎回信息.md存续期事件强赎、到期赎回公告一个典型的组装思路以ts_code为连接键发行cb_issue拿到发行规模、申购倍数、中签率判断该券发行时的市场热度上市cb_basic拿到上市日期、初始转股价、信用评级存续cb_daily拿到每日转股溢价率、纯债溢价率cb_call拿到强赎/到期赎回进展监控公告强赎后的操作窗口。这一数据链路正对应仓库中 convertible-bond SKILL 所述的可转债分析框架三维估值纯债价值/转股价值/期权价值、条款博弈下修/强赎/回售、双低策略与轮动选债其中特别强调可转债数据需通过 tushare 的可转债接口获取而cb_issue提供的是整个数据链路的起点——发行环节。七、使用注意事项分片提取单次最大 2000 条全量提取时必须按ann_date或日期区间循环分片直到取完为止总量不限制积分与频控2000 积分是调用门槛5000 积分以上频次更高高频批量抓取前应评估自身积分档位对应的限流强度单位口径发行相关金额字段单位不一致——plan_issue_size/issue_size为元而网上/网下发行总额onl_size、offl_size及配售数量为张做聚合计算前务必统一换算一张面值通常 100 元日期格式全部采用YYYYMMDD字符串输入输出一致避免混用datetime对象历史数据缺失早期可转债存在公告日等字段缺失见数据示例末行对 1990 年代末2000 年代初的老券数据需做空值容忍处理数据用途数据来源于公开披露渠道适合个人与机构研究使用若涉及商业用途需遵守数据源的使用条款约束。通过本文的字段拆解与调用示例配合仓库中 可转债基础信息.md、可转债行情.md、可转债赎回信息.md 等接口文档即可搭建覆盖可转债发行—上市—存续全流程的数据管线为打新研究、双低策略回测与条款博弈分析提供完整的数据支撑。赞分享金融科技示例工程【免费下载链接】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 服务k-skill 的 ev-subsidy-status 技能无头解析韩国电动汽车购车补贴官方页面并驱动 Agent 行动的技术指南k skill 的 ev subsidy status 技能无头解析韩国电动汽车购车补贴官方页面并驱动 Agent 行动的技术指南 导读 本文围绕 k ski金融科技示例工程ai_quant_trade 债券数据实战Tushare repo_daily 债券回购日行情的接口详解与量化调用指南ai_quant_trade 债券数据实战Tushare repo_daily 债券回购日行情的接口详解与量化调用指南 本文围绕 ai_quant_trade金融科技示例工程上一篇终极指南使用osquery实现系统配置变更管理下一篇ExplorerPatcher使用指南Windows界面定制终极教程创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考