EN
菜单
← 返回数据列表
债券
债券风险收益分析
BondRiskReturnAnalysis付费 · PlusJSON支持在线试运行
此接口需要付费授权或有效测试权限。可先查看字段和示例;在线支付尚未开放。
数据说明
该接口用于获取指定债券在特定时间区间内的多维度风险收益指标序列,涵盖多价格维度收益率、行权收益率、各类久期、凸性、信用利差等核心字段,精准支撑债券持仓风险评估、利率敏感性分析、信用利差监控、含权债行权策略研究、资产配置优化等核心业务场景,为债券投研与风险管理提供量化分析基础。
使用场景:
- 通过指定债券代码和时间区间,获取该债券在统计区间内每日的到期收益率、行权收益率,以及与国债、国开债基准的信用利差,帮助用户评估债券的绝对收益水平和相对信用风险溢价。
-提供麦氏久期、修正久期、凸性、利率久期、利差久期等关键利率风险指标,帮助用户量化债券价格对利率变动和信用利差变动的敏感程度。
-针对含权债券,提供行权口径下的风险收益指标,包括行权收益率、行权剩余期限、下一行权日,以及行权修正久期、行权利差久期、行权凸性等,帮助用户评估行权窗口期内的债券表现与决策影响。
POST /v1/data/operations/BondRiskReturnAnalysis · JSON
输入参数
| 字段 | 类型 | 约束 | 说明与示例 |
|---|---|---|---|
bondObject债券代码 | 文本列表string_array | 必填 按字典选择: BOND | 查询债券行情的债券代码,是债券唯一标识的编码 示例: |
beginDate起始日期 | 文本string | 可选 | 债券行情查询区间的起始日期 示例: |
endDate截止日期 | 文本string | 可选 | 债券行情查询区间的结束日期 示例: |
pageNo页面编号 | 数字number | 可选 | 定位分页查询的目标页码,默认值为1 示例: |
pageSize页内记录数 | 数字number | 可选 | 单页返回的最大记录条数,默认为500 示例: |
返回字段
| 字段 | 类型 | 约束 | 说明与示例 |
|---|---|---|---|
bondobject债券内码 | 文本string | — | 查询债券行情的债券代码,是债券唯一标识的编码 示例: |
bondcode债券代码 | 文本string | — | 交易所或监管机构统一分配的债券代码 示例: |
bondabbr债券简称 | 文本string | — | 交易所或监管机构统一分配的债券简称 示例: |
tradedate交易日期 | 文本string | — | 债券实际发生交易的日期 示例: |
ytm到期收益率(%) | 数字number | — | 持有债券至到期日的年化收益率。 示例: |
macaulayduration麦氏久期 | 数字number | — | 债券未来现金流的加权平均期限,衡量利率敏感度。 示例: |
modifiedduration修正久期 | 数字number | — | 久期的修正值,更精确衡量利率变动对价格的敏感度。 示例: |
convexity凸性 | 数字number | — | 衡量久期随利率变化的程度,反映价格曲线弯曲度。 示例: |
interestrateduration利率久期 | 数字number | — | 债券价格对基准利率变动的敏感度指标。 示例: |
spreadduration利差久期 | 数字number | — | 债券价格对信用利差变动的敏感度指标。 示例: |
openpriceytm开盘价到期收益率(%) | 数字number | — | 以开盘价为基础计算的到期年化收益率。 示例: |
highpriceytm最高价到期收益率(%) | 数字number | — | 以最高价为基础计算的到期年化收益率。 示例: |
lowpriceytm最低价到期收益率(%) | 数字number | — | 以最低价为基础计算的到期年化收益率。 示例: |
weightedpriceytm加权价到期收益率(%) | 数字number | — | 以加权平均价为基础计算的到期年化收益率。 示例: |
matcreditspreadtsy到期信用利差_国债(bp) | 数字number | — | 到期收益率与同期限国债收益率的基点差值。 示例: |
matcreditspreadcdb到期信用利差_国开(bp) | 数字number | — | 到期收益率与同期限国开债收益率的基点差值。 示例: |
callcreditspreadtsy行权信用利差_国债(bp) | 数字number | — | 行权收益率与同期限国债收益率的基点差值。 示例: |
callcreditspreadcdb行权信用利差_国开(bp) | 数字number | — | 行权收益率与同期限国开债收益率的基点差值。 示例: |
callremainingterm行权剩余期限 | 数字number | — | 考虑行权因素后的债券剩余年限。 示例: |
nextcalldate下一行权日 | 文本string | — | 下一个可以行使选择权的日期。 示例: |
callyield行权收益率(%) | 数字number | — | 考虑行权因素后的债券年化收益率。 示例: |
callmacaulayduration行权麦氏久期 | 数字number | — | 考虑行权因素后的麦氏久期指标。 示例: |
callmodifiedduration行权修正久期 | 数字number | — | 考虑行权因素后的修正久期指标。 示例: |
callspreadduration行权利差久期 | 数字number | — | 考虑行权因素后的利差久期指标。 示例: |
callirduration行权利率久期 | 数字number | — | 考虑行权因素后的利率久期指标。 示例: |
callconvexity行权凸性 | 数字number | — | 考虑行权因素后的凸性指标。 示例: |
调用示例
已填入示例标的、必填参数与适用的分页限制。点击试运行,在右侧抽屉查看字段说明并获取真实返回。
{
"parameters": {
"bondObject": [
"728376"
],
"pageNo": 1,
"pageSize": 5
}
}- bondObject: 25国债17 · 019790.SH
- 样例使用已核验的标的和字典值;返回记录取决于查询范围、数据更新及当前 Key 权限。
- 默认请求 5 条;部分业务聚合可能返回更多记录,以实际响应为准。
覆盖与使用边界
请先运行示例,确认所需证券、日期范围和字段是否可用。可用历史范围与内容使用许可因接口而异;查询使用账户和所选 API Key 的权限与额度。
分钟周期、复权方式和时间单位请按上方参数说明填写。接口没有返回的数据不代表数值为零。