Bonds

Institution Bond Holdings

InstitutionBondHoldings

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

Input parameters

Field	Type	Constraint	Description and example
`bondObject` 债券代码	string_array `string_array`	Required Dictionary selection: `BOND`	查询债券代码，是债券唯一标识的编码 Example: `["728376"]`
`beginDate` 起始日期	string `string`	Optional	查询机构持仓数据对应的统计开始日期，格式为“YYYY-MM-DD” Example: `Example text`
`endDate` 截止日期	string `string`	Optional	查询机构持仓数据对应的统计截止日期，格式为“YYYY-MM-DD” 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`
`bondabbr` 债券简称	string `string`	—	债券通用的证券简称 Example: `Example text`
`bondcode` 债券代码	string `string`	—	债券通用的证券代码 Example: `Example text`
`reportdate` 报告期	string `string`	—	机构持仓数据对应的统计截止日期，格式为“YYYY-MM-DD”。 Example: `Example text`
`reporttype` 报告类型	string `string`	—	报告期的类别，如年报、一季报、三季报、中报等。 Example: `Example text`
`fundholderscount` 基金持有家数(家)	number `number`	—	持有该债券的基金产品数量。 Example: `1`
`fundholdingstotal` 基金持有份额合计(张)	number `number`	—	基金持有该债券的总份额。 Example: `1`
`fundholdingmarketvalue` 基金持有市值合计(元)	number `number`	—	基金持有该债券的总市值。 Example: `1`
`fundholdingratio` 基金持仓比例(%)	number `number`	—	基金持有量占债券总存量的比例。 Example: `1`
`holdingvaluechange` 较上期持仓市值变化(元)	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.