Bonds

Bond Coupon Redemption

BondCouponRedemption

Paid · PlusJSONTry online

This API requires paid access or an active trial. Review its fields and examples first; online payments are not available yet.

Data description

Use the field names shown below when building requests.

该API用于获取指定债券在特定时间区间内的付息兑付事件明细数据，涵盖兑付日期、现金流类型、百元应付利息、百元应付本金、应付现金流、兑付余额等核心字段，精准支撑债券现金流预测、付息兑付计划管理、持仓兑付提醒、债券存续规模监控等核心业务场景。使用场景： -通过指定债券代码和兑付日期区间，获取该债券在区间内发生的所有付息兑付事件，包括兑付日期、现金流类型、百元应付利息、百元应付本金等明细信息，帮助用户全面掌握债券的现金流安排。 -提供本次兑付所需支付的总资金规模和兑付后债券剩余未偿还余额，帮助用户评估发行人的兑付压力、债券存续规模变化，以及计算持仓债券的实际现金流入。

POST /v1/data/operations/BondCouponRedemption · JSON

Input parameters

Field	Type	Constraint	Description and example
`bondObject` 债券代码	string_array `string_array`	Required Dictionary selection: `BOND`	查询债券行情的债券代码，是债券唯一标识的编码 Example: `["728376"]`
`beginDate` 起始日期	string `string`	Optional	债券兑付查询区间的起始日期 Example: `Example text`
`endDate` 截止日期	string `string`	Optional	债券兑付查询区间的结束日期 Example: `Example text`
`pageNo` 页面编号	number `number`	Optional	定位分页查询的目标页码，默认值为1 Example: `1`
`pageSize` 页内记录数	number `number`	Optional	单页返回的最大记录条数，默认为500 Example: `5`

Response fields

Field	Type	Constraint	Description and example
`bondobject` 债券内码	string `string`	—	查询债券行情的债券代码，是债券唯一标识的编码 Example: `Example text`
`bondcode` 债券代码	string `string`	—	交易所或监管机构统一分配的债券代码 Example: `Example text`
`bondabbr` 债券简称	string `string`	—	交易所或监管机构统一分配的债券简称 Example: `Example text`
`redemptiondate` 兑付日期	string `string`	—	债券进行利息支付或本金偿还的日期。 Example: `Example text`
`cashflowtype` 现金流类型	string `string`	—	区分兑付的资金性质，如付息、还本或本息同时兑付。 Example: `Example text`
`interestper` 百元应付利息(元)	number `number`	—	每百元面值债券应付的利息金额。 Example: `1`
`principalper` 百元应付本金(元)	number `number`	—	每百元面值债券应付的本金金额。 Example: `1`
`currentcouponrate` 当期票面利率(%)	number `number`	—	当前计息周期适用的票面利率。 Example: `1`
`isinteresttaxexempt` 利息是否免税	string `string`	—	标识该债券利息收入是否免征所得税。 Example: `Example text`
`cashpayable` 应付现金流(亿)	number `number`	—	本次兑付所需支付的总资金规模。 Example: `1`
`redemptionbalance` 兑付余额(亿)	number `number`	—	本次兑付后债券剩余未偿还的余额。 Example: `1`

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"
    ],
    "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.