S SPARKDATA
← 返回数据列表

债券

上清所估值

SHCHValuation
免费JSON支持在线试运行

接口试运行

上清所估值

SHCHValuation
管理 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页码从 1 开始;样例读取第一页。
pageSize页内记录数
单页返回的最大记录条数,默认值为500‘样例限制为 5 条,便于快速查看结果。
POST /v1/data/operations/SHCHValuation

curl 调用示例(含字段注释)
# bondObject: 债券代码(必填) — 查询债券代码,是债券唯一标识的编码
# beginDate: 开始日期 — 起始日期是查询估值数据的开始日期,输入格式“YYYY-MM-DD”
# endDate: 结束日期 — 截止日期是查询估值数据的截止日期,输入格式“YYYY-MM-DD”
# pageNo: 页面编号 — 定位分页查询的目标页码,默认值为1
# pageSize: 页内记录数 — 单页返回的最大记录条数,默认值为500‘
curl --silent --show-error --fail-with-body --request POST \
  'https://spark-data.cn/v1/data/operations/SHCHValuation' \
  --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 即可查询。

数据说明

获取指定债券在指定交易区间内的上清所估值指标,涵盖交易日期、代偿期、(日终)估价全价、净价、应计利息、估价收益率、估价修正久期、估价凸性、估价基点价值、估价利率久期/凸性、估价利差久期/凸性、剩余本金,支撑债券持仓公允价值计量、利率及信用风险度量、含权债估值选择等业务场景。 使用场景: -获取交易日期对应的估价全价、估价净价、估价收益率、代偿期及剩余本金,用于债券持仓的公允价值计算及到期收益分析。 -量化债券价格对利率变动和信用利差变动的敏感程度,支撑久期管理与对冲策略。 -支持按债券代码及日期区间批量查询估值序列或多只债券的同期估值。

POST /v1/data/operations/SHCHValuation · JSON

输入参数

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

示例: ["728376"]

beginDate
开始日期
文本
string
可选起始日期是查询估值数据的开始日期,输入格式“YYYY-MM-DD”

示例: 2026-10-14

endDate
结束日期
文本
string
可选截止日期是查询估值数据的截止日期,输入格式“YYYY-MM-DD”

示例: 2026-11-13

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

示例: 1

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

示例: 5

返回字段

字段类型约束说明与示例
bondobject
债券内码
文本
string
—债券唯一标识的编码

示例: 示例文本

bondabbr
债券简称
文本
string
—债券通用的证券简称

示例: 示例文本

bondcode
债券代码
文本
string
—债券通用的证券代码

示例: 示例文本

tradedate
交易日期
文本
string
—该笔估值数据对应的交易时间,格式为“YYYY-MM-DD”

示例: 示例文本

remainingterm
代偿期(年)
数字
number
—债券剩余存续年限,用于估值分析。

示例: 1

estfullprice
估价全价(元)
数字
number
—含应计利息的债券估值价格。

示例: 1

accruedinterest
应计利息(元)
数字
number
—当前周期已产生但未付的利息。

示例: 1

eodestfullprice
日终估价全价(元)
数字
number
—交易日终含应计利息的全价估值。

示例: 1

eodaccruedinterest
日终应计利息(元)
数字
number
—交易日终已产生但未付的利息。

示例: 1

estcleanprice
估价净价(元)
数字
number
—不含应计利息的债券估值价格。

示例: 1

estyield
估价收益率(%)
数字
number
—估值价格对应的到期收益率。

示例: 1

estmodifiedduration
估价修正久期
数字
number
—收益率变动1%时价格变动的近似幅度。

示例: 1

estconvexity
估价凸性
数字
number
—衡量久期随收益率变化的弯曲程度。

示例: 1

estbpv
估价基点价值
数字
number
—收益率变动1个基点对应的价格变动额。

示例: 1

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

示例: 1

estirconvexity
估价利率凸性
数字
number
—利率久期随基准利率变化的程度。

示例: 1

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

示例: 1

estspreadconvexity
估价利差凸性
数字
number
—利差久期随信用利差变化的程度。

示例: 1

remainingprincipal
剩余本金
数字
number
—当前尚未偿还的债券本金总额。

示例: 1

tradingmarket
交易市场
文本
string
—债券挂牌交易的市场场所。

示例: 示例文本

credibility
可信度
文本
string
—含权债存在行权/到期两个可能估值中更为倾向推荐的一个。

示例: 示例文本

调用示例

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

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

覆盖与使用边界

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

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