S SPARKDATA
← 返回数据列表

债券

中债估值

DebtValuation
免费JSON支持在线试运行

此接口免费开放,使用账户下任一 API Key 即可查询。

数据说明

该接口展示了中债登发布的债券对应的估值数据;支持拉取债券的中债估值时间序列数据; 返回日期,代偿期(年),估价全价(元),应计利息(元),日终估价全价(元),日终应计利息(元),估价净价(元),估价收益率(%),估价修正久期,估价凸性,估价基点价值,剩余本金,交易市场,可信度,特殊估值,特殊估值标识(权限控制用),估值曲线类型,估价利率久期。 使用场景: 1、查询单券在某日的中债估值; 2、拉取债券的中债估值时间序列数据 3、查看债券最新交易日下的估值数据

POST /v1/data/operations/DebtValuation · JSON

输入参数

字段类型约束说明与示例
bondObject
债券代码
文本列表
string_array
必填
按字典选择: BOND
债券代码是指国内债券通用的债券代码,支持一次获取多个品种数据

示例: ["728376"]

credit
可信度
文本列表
string_array
可选
按字典选择: KEXINDU
可信度是指在中债估值中,有些债券可能有多个估值(比如含权债就有一个行权价格,还有一个不行权价格),中债把两个可能的估值都会发布,同时用“可信度”这个字段来标识其中哪个估值是中债比较倾向的,标有“推荐”即中债比较倾向的估值

示例: […]

yieldCode
估值类型
文本列表
string_array
可选
按字典选择: XINGQUANDAOQI
估值类型是指债券的收益率类型,包括到期收益率和行权收益率

示例: […]

beginDate
开始日期
日期(年-月-日)
date
可选起始日期是查询中债估值数据的开始日期,输入格式“YYYY-MM-DD”

示例: 2026-10-15

endDate
截止日期
日期(年-月-日)
date
可选截止日期是查询中债估值数据的截止日期,输入格式“YYYY-MM-DD”

示例: 2026-11-14

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

示例: 1

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

示例: 5

返回字段

字段类型约束说明与示例
bondobject
债券内码
文本
string
—债券内码

示例: 示例文本

bondcode
债券代码
文本
string
—债券代码

示例: 示例文本

bondname
债券简称
文本
string
—债券简称

示例: 示例文本

enddate
日期
文本
string
—日期

示例: 示例文本

trueremainmaturity
代偿期(年)
数字
number
—代偿期(年)

示例: 1

valuefullprice
估价全价(元)
数字
number
—估价全价(元)

示例: 1

accruinterest
应计利息(元)
数字
number
—应计利息(元)

示例: 1

settfullprice
日终估价全价(元)
数字
number
—日终估价全价(元)

示例: 1

settaccruinterest
日终应计利息(元)
数字
number
—日终应计利息(元)

示例: 1

valuecleanprice
估价净价(元)
数字
number
—估价净价(元)

示例: 1

vpyield
估价收益率(%)
数字
number
—估价收益率(%)

示例: 1

vpaduration
估价修正久期
数字
number
—估价修正久期

示例: 1

vpconvexity
估价凸性
数字
number
—估价凸性

示例: 1

vppointvalue
估价基点价值
数字
number
—估价基点价值

示例: 1

residualcapital
剩余本金
数字
number
—剩余本金

示例: 1

secumarket
交易市场
文本
string
—交易市场

示例: 示例文本

credibilityname
可信度
文本
string
—可信度

示例: 示例文本

yieldnametype
估值曲线类型
文本
string
—估值曲线类型

示例: 示例文本

yieldname
估价利率久期
数字
number
—估价利率久期

示例: 1

调用示例

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

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

覆盖与使用边界

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

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