S SPARKDATA
← 返回数据列表

债券

中债估值

DebtValuation
免费JSON支持在线试运行

接口试运行

中债估值

DebtValuation
管理 API Key

正在读取账户…

示例已填好,选择 API Key 后即可运行。

使用账户的现有权限与额度。字段说明独立展示,复制出的 JSON 可直接调用。

  • bondObject: 25国债17 · 019790.SH
  • 样例使用已核验的标的和字典值;返回记录取决于查询范围、数据更新及当前 Key 权限。
  • 默认请求 5 条;部分业务聚合可能返回更多记录,以实际响应为准。
示例字段说明 5
bondObject债券代码 · 必填
债券代码是指国内债券通用的债券代码,支持一次获取多个品种数据可填写准确名称或字典代码。 25国债17 (728376)
beginDate开始日期
起始日期是查询中债估值数据的开始日期,输入格式“YYYY-MM-DD”日期格式为 YYYY-MM-DD;数组类型请用 JSON 数组。
endDate截止日期
截止日期是查询中债估值数据的截止日期,输入格式“YYYY-MM-DD”日期格式为 YYYY-MM-DD;数组类型请用 JSON 数组。
pageNo页面编号
定位分页查询的目标页码,默认不限页码从 1 开始;样例读取第一页。
pageSize页内记录数
单页返回的最大记录条数,默认不限样例限制为 5 条,便于快速查看结果。
POST /v1/data/operations/DebtValuation

curl 调用示例(含字段注释)
# bondObject: 债券代码(必填) — 债券代码是指国内债券通用的债券代码,支持一次获取多个品种数据
# beginDate: 开始日期 — 起始日期是查询中债估值数据的开始日期,输入格式“YYYY-MM-DD”
# endDate: 截止日期 — 截止日期是查询中债估值数据的截止日期,输入格式“YYYY-MM-DD”
# pageNo: 页面编号 — 定位分页查询的目标页码,默认不限
# pageSize: 页内记录数 — 单页返回的最大记录条数,默认不限
curl --silent --show-error --fail-with-body --request POST \
  'https://spark-data.cn/v1/data/operations/DebtValuation' \
  --header "Authorization: Bearer ${SPARKDATA_API_KEY:?Set SPARKDATA_API_KEY first}" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data-binary '{"parameters":{"bondObject":["728376"],"beginDate":"2026-10-14","endDate":"2026-11-13","pageNo":1,"pageSize":5}}'

此接口免费开放,使用账户下任一 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-14

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

示例: 2026-11-13

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

覆盖与使用边界

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

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