Bonds

CCDC valuation

DebtValuation

FreeJSONTry online

This API is free. Query it with any API key in your account.

Data description

Use the field names shown below when building requests.

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

POST /v1/data/operations/DebtValuation · JSON

Input parameters

Field	Type	Constraint	Description and example
`bondObject` 债券代码	string_array `string_array`	Required Dictionary selection: `BOND`	债券代码是指国内债券通用的债券代码，支持一次获取多个品种数据 Example: `["728376"]`
`credit` 可信度	string_array `string_array`	Optional Dictionary selection: `KEXINDU`	可信度是指在中债估值中，有些债券可能有多个估值(比如含权债就有一个行权价格，还有一个不行权价格)，中债把两个可能的估值都会发布，同时用“可信度”这个字段来标识其中哪个估值是中债比较倾向的，标有“推荐”即中债比较倾向的估值 Example: `[…]`
`yieldCode` 估值类型	string_array `string_array`	Optional Dictionary selection: `XINGQUANDAOQI`	估值类型是指债券的收益率类型，包括到期收益率和行权收益率 Example: `[…]`
`beginDate` 开始日期	date `date`	Optional	起始日期是查询中债估值数据的开始日期，输入格式“YYYY-MM-DD” Example: `2026-10-15`
`endDate` 截止日期	date `date`	Optional	截止日期是查询中债估值数据的截止日期，输入格式“YYYY-MM-DD” Example: `2026-11-14`
`pageNo` 页面编号	number `number`	Optional	定位分页查询的目标页码，默认不限 Example: `1`
`pageSize` 页内记录数	number `number`	Optional	单页返回的最大记录条数，默认不限 Example: `5`

Response fields

Field	Type	Constraint	Description and example
`bondobject` 债券内码	string `string`	—	债券内码 Example: `Example text`
`bondcode` 债券代码	string `string`	—	债券代码 Example: `Example text`
`bondname` 债券简称	string `string`	—	债券简称 Example: `Example text`
`enddate` 日期	string `string`	—	日期 Example: `Example text`
`trueremainmaturity` 代偿期（年）	number `number`	—	代偿期（年） Example: `1`
`valuefullprice` 估价全价（元）	number `number`	—	估价全价（元） Example: `1`
`accruinterest` 应计利息（元）	number `number`	—	应计利息（元） Example: `1`
`settfullprice` 日终估价全价（元）	number `number`	—	日终估价全价（元） Example: `1`
`settaccruinterest` 日终应计利息（元）	number `number`	—	日终应计利息（元） Example: `1`
`valuecleanprice` 估价净价（元）	number `number`	—	估价净价（元） Example: `1`
`vpyield` 估价收益率（%）	number `number`	—	估价收益率（%） Example: `1`
`vpaduration` 估价修正久期	number `number`	—	估价修正久期 Example: `1`
`vpconvexity` 估价凸性	number `number`	—	估价凸性 Example: `1`
`vppointvalue` 估价基点价值	number `number`	—	估价基点价值 Example: `1`
`residualcapital` 剩余本金	number `number`	—	剩余本金 Example: `1`
`secumarket` 交易市场	string `string`	—	交易市场 Example: `Example text`
`credibilityname` 可信度	string `string`	—	可信度 Example: `Example text`
`yieldnametype` 估值曲线类型	string `string`	—	估值曲线类型 Example: `Example text`
`yieldname` 估价利率久期	number `number`	—	估价利率久期 Example: `1`

Request example

Example instruments, required parameters and applicable page limits are prefilled. Open the side drawer for field notes and a live response.

{
  "parameters": {
    "bondObject": [
      "728376"
    ],
    "beginDate": "2026-10-15",
    "endDate": "2026-11-14",
    "pageNo": 1,
    "pageSize": 5
  }
}

bondObject: 25国债17 · 019790.SH
Samples use verified instruments and dictionary values. Records depend on the query range, data updates and the selected key's permissions.
The sample requests 5 records; some business aggregates may return more rows, as shown in the actual response.

Coverage and access boundaries

Run the example to check the securities, dates and fields you need. Available history and content rights vary by endpoint. Requests use your account access and the selected API key.

Follow the parameter notes for minute intervals, price adjustment and time units. A missing field does not mean a zero value.