S SPARKDATA
中文
Menu
← Back to data results

Bonds

SHCH valuation

SHCHValuation
FreeJSONTry online

Operation explorer

SHCH valuation

SHCHValuation
Manage API keys

Loading account…

The example is prefilled. Choose an API key and run it.

Uses the account’s current access and allowance. Field notes stay separate so copied JSON remains executable.

  • 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.
Example field notes 5
bondObjectstring_array · required
查询债券代码，是债券唯一标识的编码Use an exact name or dictionary code. 25国债17 (728376)
beginDatestring
起始日期是查询估值数据的开始日期，输入格式“YYYY-MM-DD”Use YYYY-MM-DD; wrap array values in a JSON array.
endDatestring
截止日期是查询估值数据的截止日期，输入格式“YYYY-MM-DD”Use YYYY-MM-DD; wrap array values in a JSON array.
pageNonumber
定位分页查询的目标页码，默认值为1Page numbers start at 1; the sample reads the first page.
pageSizenumber
单页返回的最大记录条数，默认值为500‘The sample requests 5 records for a quick preview.
POST /v1/data/operations/SHCHValuation

curl example with field notes
# bondObject: string_array (required) — 查询债券代码，是债券唯一标识的编码
# beginDate: string — 起始日期是查询估值数据的开始日期，输入格式“YYYY-MM-DD”
# endDate: string — 截止日期是查询估值数据的截止日期，输入格式“YYYY-MM-DD”
# pageNo: number — 定位分页查询的目标页码，默认值为1
# pageSize: number — 单页返回的最大记录条数，默认值为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-15","endDate":"2026-11-14","pageNo":1,"pageSize":5}}'

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/SHCHValuation · JSON

Input parameters

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

Example: ["728376"]

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

Example: 2026-10-15

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

Example: 2026-11-14

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

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

eodaccruedinterest
日终应计利息(元)		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

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

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

Example: 1

tradingmarket
交易市场		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-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.