企业官网建设流程全解析

• 金融科技
• 示例工程

导读

可转债发行数据是研究"打新"（可转债申购）、分析发行定价与申购火爆程度的第一手数据。本文聚焦 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等 1998～2000 年发行的老券）。

在调用该接口前，需要注意两条硬性约束：

• 单次限量：单次调用最大返回 2000 条记录，可多次提取，总量不限制——即需要通过设置start_date/end_date或ann_date分片循环拉取全量数据；
• 积分门槛：用户至少需要 2000 积分方可调取，5000 积分以上频次相对较高，积分越多权限越大（积分获取方式详见 Tushare 官方积分文档，本文不赘述外部链接）。

接口在 Tushare skill 包中的完整说明位于 可转债发行.md，在 SKILL.md 的接口清单中对应 ID 186，分类为"债券专题"。

二、输入参数详解

cb_issue共支持 4 个输入参数，全部可选（必选列均为 N），按需组合即可：

参数使用要点：

• 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等个别字段默认不显示），完整输出参数如下表，按逻辑可划分为四组：发行基础信息、网上发行、老股东配售、网下发行。

字段解读要点：

1. 发行基础信息组（plan_issue_size～issue_type）：用于判断发行规模与方式。plan_issue_size与issue_size的差异可反映实际发行是否足额；issue_type标识发行方式（如配售/申购等组合方式）；
2. 网上发行组（onl_*）：对应普通投资者参与的"打新"环节。核心指标是onl_pch_excess（超额认购倍数）与onl_winning_rate（中签率）——超额认购倍数越高、中签率越低，说明申购越火爆；
3. 老股东配售组（shd_ration_*）：对应原股东优先配售环节，shd_ration_ratio为配售比例，shd_ration_record_date（股权登记日）决定了享有配售权的股东名册截点；
4. 网下发行组（offl_*）：对应机构网下申购环节，offl_deposit为网下发行定金比例，是衡量参与门槛的重要指标；
5. 承销信息（lead_underwriter/lead_underwriter_vol）：主承销商及其包销数量，可用于研究承销商在发行中的兜底力度。

四、接口调用示例

以下为仓库文档中给出的标准调用方式（完整代码见 可转债发行.md）：

pro = ts.pro_api() # 获取可转债发行数据（按发行公告日） df = pro.cb_issue(ann_date='20190612') # 获取可转债发行数据，自定义字段 df = pro.cb_issue(fields='ts_code,ann_date,issue_size')

调用前的准备流程（依据 SKILL.md 的"快速上手"章节）：

# 安装 tushare（推荐从清华 pypi 镜像安装） pip install tushare -i https://pypi.tuna.tsinghua.edu.cn/simple

# 注册 Tushare 官网账号获取 token，并配置环境变量 export TUSHARE_TOKEN=your_token

import 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_date='20190612') print(df)

需要注意：ts.pro_api()若不显式传入 token，会尝试读取本地配置；显式传入环境变量 token 的方式更利于在脚本、定时任务中复用，仓库中 股票数据获取示例 与 基金数据获取示例 也遵循同样的初始化模式。

五、返回数据示例解读

以fields='ts_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 债券专题下的其他可转债接口组合。这些接口在仓库中均有独立文档，位于同一目录 债券专题 下：

一个典型的组装思路（以ts_code为连接键）：

1. 发行：cb_issue拿到发行规模、申购倍数、中签率，判断该券发行时的市场热度；
2. 上市：cb_basic拿到上市日期、初始转股价、信用评级；
3. 存续：cb_daily拿到每日转股溢价率、纯债溢价率；cb_call拿到强赎/到期赎回进展，监控"公告强赎"后的操作窗口。

这一数据链路正对应仓库中 convertible-bond SKILL 所述的可转债分析框架：三维估值（纯债价值/转股价值/期权价值）、条款博弈（下修/强赎/回售）、双低策略与轮动选债，其中特别强调"可转债数据需通过 tushare 的可转债接口获取"，而cb_issue提供的是整个数据链路的起点——发行环节。

七、使用注意事项

1. 分片提取：单次最大 2000 条，全量提取时必须按ann_date或日期区间循环分片，直到取完为止（总量不限制）；
2. 积分与频控：2000 积分是调用门槛，5000 积分以上频次更高；高频批量抓取前应评估自身积分档位对应的限流强度；
3. 单位口径：发行相关金额字段单位不一致——plan_issue_size/issue_size为元，而网上/网下发行总额（onl_size、offl_size）及配售数量为张，做聚合计算前务必统一换算（一张面值通常 100 元）；
4. 日期格式：全部采用YYYYMMDD字符串，输入输出一致，避免混用datetime对象；
5. 历史数据缺失：早期可转债存在公告日等字段缺失（见数据示例末行），对 1990 年代末～2000 年代初的老券数据需做空值容忍处理；
6. 数据用途：数据来源于公开披露渠道，适合个人与机构研究使用；若涉及商业用途，需遵守数据源的使用条款约束。

通过本文的字段拆解与调用示例，配合仓库中 可转债基础信息.md、可转债行情.md、可转债赎回信息.md 等接口文档，即可搭建覆盖可转债"发行—上市—存续"全流程的数据管线，为打新研究、双低策略回测与条款博弈分析提供完整的数据支撑。

• 金融科技
• 示例工程