Filtered search for fixed income instruments
Returns a paged list of fixed income instruments from the bonds hub with support for filtering, sorting, and pagination.
Page number (zero-based)
Number of items per page
Property to sort by
Sort direction
Filter by issuer name
Filter by issuer symbol(s)
Filter by bond status
Filter by bond type(s)
Filter by treasury subtype(s)
Filter by S&P credit rating(s)
Filter by rating category
Filter by S&P outlook
Filter by S&P creditwatch status
Filter by coupon payment frequency
Minimum coupon rate
Maximum coupon rate
Minimum maturity date (yyyy-MM-dd format). Defaults to today + 14 days to exclude bonds nearing maturity with volatile yields.
Maximum maturity date (yyyy-MM-dd format)
Minimum current yield
Maximum current yield
Minimum par value
Maximum par value
Minimum liquidity rating
Maximum liquidity rating
Filter by specific liquidity rating(s) - Scores from 1 (low) to 5 (high)
Filter by callable status
Filter by perpetual bond status
Filter by partial par status
| Name | Type | Required | Description |
|---|---|---|---|
| pageNumber | integer | No | Page number (zero-based) |
| pageSize | integer | No | Number of items per page |
| sortProperty | string | No | Property to sort by |
| sortDirection | stringASCDESC | No | Sort direction |
| issuer | string | No | Filter by issuer name |
| issuerSymbol | array | No | Filter by issuer symbol(s) |
| bondStatus | arrayLIQUIDATEDCONVERTEDFUNGEDREPAIDRESTRUCTUREDCALLEDDEFAULTEDMATUREDOUTSTANDINGPUTTENDEREDREPURCHASEDPRE_ISSUANCEUNKNOWN | No | Filter by bond status |
| bondType | arrayAGENCYCDCORPORATEGOVERNMENTMUNICIPALTREASURY | No | Filter by bond type(s) |
| treasurySubtype | arrayBONDBILLNOTESTRIPSTIPSFLOATING | No | Filter by treasury subtype(s) |
| rating | arrayAAAAA+AAAA-SP-1+A-1+A+AA-1A-SP-1BBB+A-2BBBBBB-A-3BB+BBBB-B+BB-CCC+CCCCCC-CCCDNR | No | Filter by S&P credit rating(s) |
| ratingCategory | stringINVESTMENT_GRADESPECULATIVE_GRADE | No | Filter by rating category |
| spOutlook | arrayPOSITIVENEGATIVEDEVELOPINGSTABLENOT_RATEDNOT_MEANINGFUL | No | Filter by S&P outlook |
| spCreditwatch | arrayPOSITIVENEGATIVEDEVELOPINGNOT_MEANINGFUL | No | Filter by S&P creditwatch status |
| couponFrequency | arrayAT_MATURITYZEROMONTHLYQUARTERLYSEMI_ANNUALANNUAL | No | Filter by coupon payment frequency |
| minCoupon | number | No | Minimum coupon rate |
| maxCoupon | number | No | Maximum coupon rate |
| minMaturityDate | string (date) | No | Minimum maturity date (yyyy-MM-dd format). Defaults to today + 14 days to exclude bonds nearing maturity with volatile yields. |
| maxMaturityDate | string (date) | No | Maximum maturity date (yyyy-MM-dd format) |
| minCurrentYield | number | No | Minimum current yield |
| maxCurrentYield | number | No | Maximum current yield |
| minParValue | number | No | Minimum par value |
| maxParValue | number | No | Maximum par value |
| minLiquidityRating | number | No | Minimum liquidity rating |
| maxLiquidityRating | number | No | Maximum liquidity rating |
| liquidityRating | array | No | Filter by specific liquidity rating(s) - Scores from 1 (low) to 5 (high) |
| callable | boolean | No | Filter by callable status |
| perpetual | boolean | No | Filter by perpetual bond status |
| partialPar | boolean | No | Filter by partial par status |
No request body defined
{
"totalElements": 1234567890,
"totalPages": 123,
"size": 123,
"content": [
{
"cusip": "string",
"issuer": "string",
"issuerSymbol": "string",
"symbol": "string",
"description": "string",
"descriptionShort": "string",
"bondType": "string",
"treasurySubtype": "string",
"treasuryDuration": "string",
"bondStatus": "string",
"issueDate": "2023-11-07",
"issuePrice": "string",
"issueSize": "string",
"maturityDate": "2023-11-07",
"rating": "string",
"ratingCategory": "string",
"coupon": "string",
"couponFrequency": "string",
"nextCouponDate": "2023-11-07",
"parValue": "string",
"accruedInterest": "string",
"callable": true,
"nextCallDate": "2023-11-07",
"nextCallPrice": "string",
"currentYield": "string",
"currentPrice": "string",
"spOutlook": "string",
"spOutlookDate": "2023-11-07",
"spCreditwatch": "string",
"spCreditwatchDate": "2023-11-07",
"perpetual": true,
"countryIssue": "string",
"countryDomicile": "string",
"daysUntilMaturity": 1234567890,
"liquidityRating": "string",
"seniority": "string",
"partialPar": true,
"minimumOrderSize": "string",
"minimumOrderIncrement": "string"
}
],
"number": 123,
"numberOfElements": 123,
"sort": {
"empty": true,
"sorted": true,
"unsorted": true
},
"pageable": {
"offset": 1234567890,
"pageSize": 123,
"sort": {
"empty": true,
"sorted": true,
"unsorted": true
},
"unpaged": true,
"pageNumber": 123,
"paged": true
},
"first": true,
"last": true,
"empty": true
}