Search bonds
bondterminal_search_bondsSearch and screen bonds by free text and REST-compatible filters; optionally return facets. YTM is percent, semi-annual bond-equivalent (S.A.) for every bond; spreads are basis points on the same basis, except EUR bonds, whose spreads are over the Bund curve on the annual basis (spreads.benchmark BUND, yields.ytmAnnual); and prices are per 100 face. Yield conventions: https://bondterminal.com/methodology/yields Page size is capped at 500. Rows give the G-spread as gSpread; oas is a deprecated alias with the same value, not an option-adjusted spread. Billing: 1 read unit per row returned (minimum 1). Basic keys get up to 50 rows per page.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "bondterminal_search_bonds"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free text: issuer, ticker, ISIN, CUSIP or words in the bond name. | |
| page | No | Paging: size is rows per page; cursor comes from the previous page. | |
| sector | No | Issuer sectors, for example ["Sovereign","Energy"]. Same as filters.sector. | |
| country | No | Issuer countries as two-letter ISO codes, for example ["AR","MX"]. Same as filters.country. | |
| filters | No | Screens, for example country (ISO codes), sector, currency, couponMin/couponMax (percent), maturityDateFrom/maturityDateTo (YYYY-MM-DD), ratingMin/ratingMax, ytwMin/ytwMax (percent) and spreadBpsMin/spreadBpsMax. | |
| include_facets | No | Also return counts of the matching bonds by field. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | Yes | ||
| capped | No | ||
| facets | No | ||
| warnings | No | ||
| nextCursor | No | ||
| estimatedTotal | No |