S SPARKDATA
← Back to data results

Bonds

CSI valuation

CSIValuation
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.

获取指定债券在指定交易区间内的中证估值指标,涵盖交易日期、估价全价、应计利息、估价净价、估价收益率、估价修正久期、估价凸性,并支持按可信度及行权/到期估值类型筛选,支撑债券持仓公允价值计量、利率风险度量、含权债估值选择等业务场景。 使用场景: -获取交易日期对应的估价全价、应计利息、估价净价及估价收益率,用于债券持仓的公允价值计算与到期收益分析。 -支持按可信度和估值曲线类型(到期/行权)筛选数据,帮助用户在行权与到期两个可能估值中选择更合理的方案。 -支持按债券代码、日期区间及估值类型批量查询估值序列或多只债券的同期估值。

POST /v1/data/operations/CSIValuation · JSON

Input parameters

FieldTypeConstraintDescription and example
bondObject
债券代码
string_array
string_array
Required
Dictionary selection: BOND
查询债券代码,是债券唯一标识的编码

Example: ["728376"]

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

Example: Example text

yieldCode
行权和到期
string
string
Optional
Dictionary selection: XINGQUANDAOQI
估值类型是指债券的收益率类型,包括到期收益率和行权收益率

Example: Example text

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

Example: 2026-10-14

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

Example: 2026-11-13

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

Example: 1

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

Example: 5

Response fields

FieldTypeConstraintDescription and example
bondobject
债券内码
string
string
—债券唯一标识的编码

Example: Example text

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

Example: Example text

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

Example: Example text

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

Example: Example text

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: Example text

valuationcurvetype
估值曲线类型
string
string
—估值类型是指债券的收益率类型,包括到期收益率和行权收益率,用于区分估值曲线是建立在行权还是到期的假设之下。

Example: Example text

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

Example: Example text

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-14",
    "endDate": "2026-11-13",
    "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.