S SPARKDATA
← 返回数据列表

债券

中证估值

CSIValuation
免费JSON支持在线试运行

接口试运行

中证估值

CSIValuation
管理 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/CSIValuation

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/CSIValuation' \
  --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/CSIValuation · JSON

输入参数

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

示例: ["728376"]

credit
可信度
文本
string
可选
按字典选择: KEXINDU
用于标记当债券存在行权收益和到期收益等多个估值可能时,哪一个是更倾向采用的估值。

示例: 示例文本

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

示例: 示例文本

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”

示例: 示例文本

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

示例: 1

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

示例: 1

estcleanprice
估价净价
数字
number
—剔除应计利息后的债券估值价格。

示例: 1

estyield
估价收益率
数字
number
—全价对应的债券收益率。

示例: 1

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

示例: 1

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

示例: 1

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

示例: 示例文本

valuationcurvetype
估值曲线类型
文本
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 的权限与额度。

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