get_bond_events
Retrieve bond coupon payments, offers, maturity, amortization, and conversion events for an instrument, with optional type and date range filters.
Instructions
Get bond events: coupon payments, offers (calls), maturity, conversions.
Without dates the API returns only a window of a few years around today, so a bond's maturity or a distant offer needs an explicit from_date/to_date range to show up. A field of an event that is zero or empty is left out.
A coupon event carries couponInterestRate, the coupon's rate in percent a year — the
bond itself (get_bond_by) does not have it. Partial repayments (amortization) come as
MTY events with operationType "OA" and value in percent of the nominal; the final
repayment is the MTY event with operationType "OM".
Args: instrument_id: Bond ticker, FIGI, ISIN or UID type: Event type filter (empty = all): CPN (coupon), CALL (offer), MTY (maturity and amortization), CONV (conversion) from_date: Start date (YYYY-MM-DD), default: chosen by the API to_date: End date (YYYY-MM-DD, inclusive), default: chosen by the API
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"instrument_id": "<instrument_id>"
},
"name": "get_bond_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| to_date | No | ||
| from_date | No | ||
| instrument_id | Yes |