S SPARKDATA
← 返回数据列表

债券

债券风险收益分析

BondRiskReturnAnalysis
付费 · PlusJSON支持在线试运行
按年订阅此接口

此接口需要付费授权或有效测试权限。可先查看字段和示例;在线支付尚未开放。

数据说明

该接口用于获取指定债券在特定时间区间内的多维度风险收益指标序列,涵盖多价格维度收益率、行权收益率、各类久期、凸性、信用利差等核心字段,精准支撑债券持仓风险评估、利率敏感性分析、信用利差监控、含权债行权策略研究、资产配置优化等核心业务场景,为债券投研与风险管理提供量化分析基础。 使用场景: - 通过指定债券代码和时间区间,获取该债券在统计区间内每日的到期收益率、行权收益率,以及与国债、国开债基准的信用利差,帮助用户评估债券的绝对收益水平和相对信用风险溢价。 -提供麦氏久期、修正久期、凸性、利率久期、利差久期等关键利率风险指标,帮助用户量化债券价格对利率变动和信用利差变动的敏感程度。 -针对含权债券,提供行权口径下的风险收益指标,包括行权收益率、行权剩余期限、下一行权日,以及行权修正久期、行权利差久期、行权凸性等,帮助用户评估行权窗口期内的债券表现与决策影响。

POST /v1/data/operations/BondRiskReturnAnalysis · JSON

输入参数

字段类型约束说明与示例
bondObject
债券代码
文本列表
string_array
必填
按字典选择: BOND
查询债券行情的债券代码,是债券唯一标识的编码

示例: ["728376"]

beginDate
起始日期
文本
string
可选债券行情查询区间的起始日期

示例: 示例文本

endDate
截止日期
文本
string
可选债券行情查询区间的结束日期

示例: 示例文本

pageNo
页面编号
数字
number
可选定位分页查询的目标页码,默认值为1

示例: 1

pageSize
页内记录数
数字
number
可选单页返回的最大记录条数,默认为500

示例: 5

返回字段

字段类型约束说明与示例
bondobject
债券内码
文本
string
—查询债券行情的债券代码,是债券唯一标识的编码

示例: 示例文本

bondcode
债券代码
文本
string
—交易所或监管机构统一分配的债券代码

示例: 示例文本

bondabbr
债券简称
文本
string
—交易所或监管机构统一分配的债券简称

示例: 示例文本

tradedate
交易日期
文本
string
—债券实际发生交易的日期

示例: 示例文本

ytm
到期收益率(%)
数字
number
—持有债券至到期日的年化收益率。

示例: 1

macaulayduration
麦氏久期
数字
number
—债券未来现金流的加权平均期限,衡量利率敏感度。

示例: 1

modifiedduration
修正久期
数字
number
—久期的修正值,更精确衡量利率变动对价格的敏感度。

示例: 1

convexity
凸性
数字
number
—衡量久期随利率变化的程度,反映价格曲线弯曲度。

示例: 1

interestrateduration
利率久期
数字
number
—债券价格对基准利率变动的敏感度指标。

示例: 1

spreadduration
利差久期
数字
number
—债券价格对信用利差变动的敏感度指标。

示例: 1

openpriceytm
开盘价到期收益率(%)
数字
number
—以开盘价为基础计算的到期年化收益率。

示例: 1

highpriceytm
最高价到期收益率(%)
数字
number
—以最高价为基础计算的到期年化收益率。

示例: 1

lowpriceytm
最低价到期收益率(%)
数字
number
—以最低价为基础计算的到期年化收益率。

示例: 1

weightedpriceytm
加权价到期收益率(%)
数字
number
—以加权平均价为基础计算的到期年化收益率。

示例: 1

matcreditspreadtsy
到期信用利差_国债(bp)
数字
number
—到期收益率与同期限国债收益率的基点差值。

示例: 1

matcreditspreadcdb
到期信用利差_国开(bp)
数字
number
—到期收益率与同期限国开债收益率的基点差值。

示例: 1

callcreditspreadtsy
行权信用利差_国债(bp)
数字
number
—行权收益率与同期限国债收益率的基点差值。

示例: 1

callcreditspreadcdb
行权信用利差_国开(bp)
数字
number
—行权收益率与同期限国开债收益率的基点差值。

示例: 1

callremainingterm
行权剩余期限
数字
number
—考虑行权因素后的债券剩余年限。

示例: 1

nextcalldate
下一行权日
文本
string
—下一个可以行使选择权的日期。

示例: 示例文本

callyield
行权收益率(%)
数字
number
—考虑行权因素后的债券年化收益率。

示例: 1

callmacaulayduration
行权麦氏久期
数字
number
—考虑行权因素后的麦氏久期指标。

示例: 1

callmodifiedduration
行权修正久期
数字
number
—考虑行权因素后的修正久期指标。

示例: 1

callspreadduration
行权利差久期
数字
number
—考虑行权因素后的利差久期指标。

示例: 1

callirduration
行权利率久期
数字
number
—考虑行权因素后的利率久期指标。

示例: 1

callconvexity
行权凸性
数字
number
—考虑行权因素后的凸性指标。

示例: 1

调用示例

已填入示例标的、必填参数与适用的分页限制。点击试运行,在右侧抽屉查看字段说明并获取真实返回。

{
  "parameters": {
    "bondObject": [
      "728376"
    ],
    "pageNo": 1,
    "pageSize": 5
  }
}
  • bondObject: 25国债17 · 019790.SH
  • 样例使用已核验的标的和字典值;返回记录取决于查询范围、数据更新及当前 Key 权限。
  • 默认请求 5 条;部分业务聚合可能返回更多记录,以实际响应为准。

覆盖与使用边界

请先运行示例,确认所需证券、日期范围和字段是否可用。可用历史范围与内容使用许可因接口而异;查询使用账户和所选 API Key 的权限与额度。

分钟周期、复权方式和时间单位请按上方参数说明填写。接口没有返回的数据不代表数值为零。