Skip to main content
Glama
Finance Toolkit

Finance Toolkit

fixed_income

Read-onlyIdempotent

Calculate bond and rate metrics—prices, yields, duration, spreads, default probabilities, and mortgage payments—from real bonds and Treasury curves, avoiding manual data entry.

Instructions

Bond calculations on real bonds and market curves; nothing needs to be typed in. The bond calculations (collect_bond_statistics for all measures at once, get_present_value, get_duration, get_yield_to_maturity, get_z_spread, get_key_rate_duration, get_taylor_price_change) return one row per bond with its issuer, coupon, maturity and market price. Without arguments they use the benchmark US Treasuries (the note or bond maturing closest to 2, 3, 5, 7, 10, 20 and 30 years out) from the Treasury's FedInvest prices. Select bonds with bonds= (CUSIPs or ISINs; Treasury CUSIPs start with 912), issuer= (text in the issuer name, e.g. 'APPLE INC', read from bond ETF holdings, which needs a FinancialModelingPrep API key and has only the latest prices), maturity_start=/maturity_end= (YYYY-MM-DD; alone they select every Treasury bill, note and bond maturing in between), etfs= and date= (the day of the Treasury prices). The present value, Z-spread and key rate durations use the US Treasury zero-coupon curve of the price date; yields are semi-annual bond-equivalent decimals and prices clean per 100 of par. TIPS yields are real yields and have no present value or Z-spread on the nominal curve; floating rate notes are left out. get_bond_equivalent_yield lists every Treasury bill with its discount yield and bond-equivalent yield. The rate calculations read the government bond curves of a country (country=, default United States) on a day (date=): get_forward_rate (near_maturity=, far_maturity=, on the zero-coupon curve, annually compounded), get_par_yield (years_to_maturity=, any maturity from the zero-coupon curve), get_yield_curve_spread (long_maturity=, short_maturity=, on the par curve, e.g. 10Y-2Y) and get_breakeven_inflation_rate (US nominal minus TIPS par yields). get_taylor_price_change with from_date= (YYYY-MM-DD) instead of yield_change= measures each Treasury from that day to date=: its own Yield Change, the Taylor estimate of the price change for it (Price Change) and the Realised Price Change of its clean FedInvest price, side by side; the Treasuries are selected on from_date and a weekend or holiday uses the business day before it. get_implied_default_probability turns the latest ICE BofA spread per rating (ratings='BBB,B') into hazard rates and default probabilities (recovery_rate=0.4, horizons='1,5,10'); it needs a FRED API key. get_treasury_securities lists every marketable US Treasury (about 460 bills, notes, bonds, TIPS and FRNs, by CUSIP) with price, yield and duration (date=, security_type='Bill'|'Note'|'Bond'|'TIPS'|'FRN', bonds=). get_bond_universe lists about 9,000 US corporate bonds (investment grade and high yield, by ISIN) from the daily holdings of bond ETFs, with the G-Spread over the Treasury par curve; narrow it with issuer=, bonds=, maturity_start=/maturity_end= and show_columns; etfs= picks other iShares bond funds (default 'LQD,IGSB,USHY', e.g. 'HYG' or 'MUB'). Yields are to maturity, so a callable bond above its call price yields less to its call date. get_issuer_spreads compares issuers at the same maturities: per issuer the G-Spread interpolated between its own bonds at maturity_years= (default '2,3,5,7,10,20,30', e.g. '5' for five years), with the number of Bonds and the Shortest and Longest maturities they cover; no spread outside that range (e.g. issuer='APPLE INC,BOEING,FORD MOTOR CREDIT,INTEL' with maturity_years='4.5'). Mortgage calculations at the weekly US 30-year fixed mortgage rate (Freddie Mac; a nominal annual rate compounded monthly), one row per survey date between start_date and end_date: get_loan_payment (the Payment, Total Interest and First Payment Interest of a new loan at each rate; principal= default 400000, years= default 30, payments_per_year= default 12), get_affordable_loan (the Affordable Loan a fixed payment repays at each rate and its Change since the first date; payment= defaults to the payment of principal= at the first rate in the range, so start_date='2021-01-01' compares today's loan with the same monthly budget in January 2021) and get_amortization_schedule (one row per payment with the Interest, Principal and Balance of a new loan at the rate of date=, default the latest).

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": {
      "indicator": "<indicator>"
    },
    "name": "fixed_income"
  }
}

Input Schema

NameRequiredDescriptionDefault
dateNoThe date of the rate (YYYY-MM-DD).
etfsNoThe bond ETFs to select bonds from, see `get_bond_universe`.
rankNotrue ranks the tickers (or countries) within every period, from the highest value (rank 1) to the lowest, and compares each with its neighbour toward the middle of the ranking: the Difference (in points for returns) and the Multiple (only when both have the same sign), so the first and last rank show how far the best and the worst stand apart, e.g. a fall more than twice as large as the next one. Needs a value per period and ticker; pick one field with show_columns where there are more.
bondsNoCUSIPs or ISINs, see `collect_bond_statistics`.
limitNoThe rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead, and rows per ticker (an earnings calendar) are selected per ticker. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. 0 returns every row.
yearsNoThe term of the loan in years. The rate stays the 30-year fixed mortgage rate for another term.
issuerNoPart of an issuer's name, such as "Apple".
countryNoFor get_par_yield, get_forward_rate: The country, see `get_zero_coupon_curve`. For get_yield_curve_spread: The country, see `get_government_bond_yield_curve`.United States
paymentNoThe payment per period.
ratingsNoThe ratings: "AAA", "AA", "A", "BBB", "BB", "B" or "CCC", as a list or a comma-separated string.
end_dateNoEnd of the date range in YYYY-MM-DD format; left empty, today (or the indicator's own window).
horizonsNoThe horizons in years, as a list or a comma-separated string.
countriesNoCountry names, comma-separated or as a list, e.g. 'United States,Germany,Japan'.
from_dateNoThe day (YYYY-MM-DD) to measure each Treasury's yield and price change from, up to `date`; a weekend or holiday uses the business day before it.
indicatorYesName of the specific metric to calculate, one of the listed values. Required — search_metrics finds the indicator (and its tool) for a metric by name.
principalNoFor get_loan_payment, get_amortization_schedule: The amount borrowed. For get_affordable_loan: The loan whose payment at the first rate is used when no payment is given.
quarterlyNoReturn quarterly data instead of annual when True.
start_dateNoStart of the date range in YYYY-MM-DD format; left empty, five years before today (or the indicator's own window).
far_maturityNoThe further maturity (or maturities), in years or as labels such as '10Y'.
maturity_endNoFor collect_bond_statistics, get_present_value, get_duration, get_yield_to_maturity, get_z_spread, get_key_rate_duration, get_taylor_price_change: The latest maturity (YYYY-MM-DD). For get_bond_universe: Keeps the bonds maturing on or before this date (YYYY-MM-DD).
show_columnsNoComma-separated names to filter the output. For historical data use the key names visible in any response record (e.g. 'Close,Volume,Return'). For financial statements use the 'metric' field values from the response (e.g. 'Revenue,Net Income,EBITDA'). Call the tool once without this parameter to see all available names, then repeat with show_columns to reduce response size and token usage.
yield_changeNoFor get_key_rate_duration: The shock to each key rate (decimal). For get_taylor_price_change: The change in the yield to maturity (decimal), negative for a fall. Leave unset to use the default of the indicator you selected. Defaults are 0.0001 for get_key_rate_duration; None for get_taylor_price_change.
duration_typeNoThe duration: "modified", "macaulay", "effective" or "dollar".modified
long_maturityNoThe longer maturity (or maturities), in years or as labels such as '10Y'.
near_maturityNoThe nearer maturity (or maturities), in years or as labels such as '6M'.
recovery_rateNoThe share of the face value recovered on default, the scenario the probabilities assume.
security_typeNoThe kind of security: "Bill", "Note", "Bond", "TIPS" or "FRN", or several (a list or a comma-separated string).
maturity_startNoFor collect_bond_statistics, get_present_value, get_duration, get_yield_to_maturity, get_z_spread, get_key_rate_duration, get_taylor_price_change: The earliest maturity (YYYY-MM-DD). For get_bond_universe: Keeps the bonds maturing on or after this date (YYYY-MM-DD).
maturity_yearsNoComma-separated maturities in years to return, e.g. '1,2,5,10,20,30'.
short_maturityNoThe shorter maturity (or maturities), in years or as labels such as '3M'.
key_rate_maturityNoThe maturities of the Treasury curve to shock, in years or as labels such as '2Y' (one of the curve's maturities: 1M, 1.5M, 2M, 3M, 4M, 6M, 1Y, 2Y, 3Y, 5Y, 7Y, 10Y, 20Y and 30Y).
payments_per_yearNoThe number of payments per year.
years_to_maturityNoYears remaining until the bond matures.

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changedv2.3.4
    • changedInput schema / properties / date / description
      Previous value: -"The day of the prices (YYYY-MM-DD)."New value: +"The date of the rate (YYYY-MM-DD)."
    • changedInput schema / properties / etfs / description
      Previous value: -"For collect_bond_statistics: The bond ETFs whose holdings to select bonds from, see `get_bond_universe`. For get_present_value, get_duration, get_yield_to_maturity, get_z_spread, get_key_rate_duration, get_taylor_price_change: The bond ETFs to select bonds from, see `get_bond_universe`. For get_bond_universe: The bond ETFs to read the holdings of, as a list or a comma-separated string. The holdings must name each bond as \"ISSUER COUPON% MM/DD/YYYY\" with a par amount, as iShares funds do."New value: +"The bond ETFs to select bonds from, see `get_bond_universe`."
    • addedInput schema / properties / from_date
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The day (YYYY-MM-DD) to measure each Treasury's yield and price change from, up to `date`; a weekend or holiday uses the business day before it."
      +}
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "collect_bond_statistics",
      -  "get_present_value",
      -  "get_duration",
      -  "get_yield_to_maturity",
      -  "get_z_spread",
      -  "get_key_rate_duration",
      -  "get_taylor_price_change",
      -  "get_bond_equivalent_yield",
      -  "get_par_yield",
      -  "get_forward_rate",
      -  "get_yield_curve_spread",
      -  "get_breakeven_inflation_rate",
      -  "get_implied_default_probability",
      -  "get_treasury_securities",
      -  "get_bond_universe"
      -]New value: +[
      +  "collect_bond_statistics",
      +  "get_present_value",
      +  "get_duration",
      +  "get_yield_to_maturity",
      +  "get_z_spread",
      +  "get_key_rate_duration",
      +  "get_taylor_price_change",
      +  "get_bond_equivalent_yield",
      +  "get_par_yield",
      +  "get_forward_rate",
      +  "get_yield_curve_spread",
      +  "get_breakeven_inflation_rate",
      +  "get_implied_default_probability",
      +  "get_treasury_securities",
      +  "get_bond_universe",
      +  "get_issuer_spreads",
      +  "get_loan_payment",
      +  "get_affordable_loan",
      +  "get_amortization_schedule"
      +]
    • changedInput schema / properties / issuer / description
      Previous value: -"For collect_bond_statistics: Part of an issuer's name, such as \"Apple\", to select its bonds from the bond ETF holdings. For get_present_value, get_duration, get_yield_to_maturity, get_z_spread, get_key_rate_duration, get_taylor_price_change: Part of an issuer's name, such as \"Apple\". For get_bond_universe: Keeps the bonds whose issuer contains this text (case-insensitive), e.g. \"APPLE\" or \"JPMORGAN\", or any of several."New value: +"Part of an issuer's name, such as \"Apple\"."
    • addedInput schema / properties / maturity_years
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Comma-separated maturities in years to return, e.g. '1,2,5,10,20,30'."
      +}
    • addedInput schema / properties / payment
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The payment per period."
      +}
    • addedInput schema / properties / payments_per_year
      Added value: +{
      +  "default": 12,
      +  "description": "The number of payments per year.",
      +  "type": "integer"
      +}
    • addedInput schema / properties / principal
      Added value: +{
      +  "default": 400000,
      +  "description": "For get_loan_payment, get_amortization_schedule: The amount borrowed. For get_affordable_loan: The loan whose payment at the first rate is used when no payment is given.",
      +  "type": "number"
      +}
    • addedInput schema / properties / rank
      Added value: +{
      +  "default": false,
      +  "description": "true ranks the tickers (or countries) within every period, from the highest value (rank 1) to the lowest, and compares each with its neighbour toward the middle of the ranking: the Difference (in points for returns) and the Multiple (only when both have the same sign), so the first and last rank show how far the best and the worst stand apart, e.g. a fall more than twice as large as the next one. Needs a value per period and ticker; pick one field with show_columns where there are more.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / years
      Added value: +{
      +  "default": 30,
      +  "description": "The term of the loan in years. The rate stays the 30-year fixed mortgage rate for another term.",
      +  "type": "number"
      +}
    • changedInput schema / properties / yield_change / description
      Previous value: -"For get_key_rate_duration: The shock to each key rate (decimal). For get_taylor_price_change: The change in the yield to maturity (decimal), negative for a fall. Leave unset to use the default of the indicator you selected. Defaults are 0.0001 for get_key_rate_duration; 0.01 for get_taylor_price_change."New value: +"For get_key_rate_duration: The shock to each key rate (decimal). For get_taylor_price_change: The change in the yield to maturity (decimal), negative for a fall. Leave unset to use the default of the indicator you selected. Defaults are 0.0001 for get_key_rate_duration; None for get_taylor_price_change."
  2. Changed48 schema fields changedv2.3.3
    • removedInput schema / properties / bond_price
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "items": {
      -        "type": "number"
      -      },
      -      "type": "array"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "Clean price of the bond per 100 face value. Leave unset to use the default of the indicator you selected. Defaults are None for get_yield_to_maturity, get_z_spread; 100.0 for get_option_adjusted_spread."
      -}
    • addedInput schema / properties / bonds
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "CUSIPs or ISINs, see `collect_bond_statistics`."
      +}
    • removedInput schema / properties / call_price
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": 100,
      -  "description": "The price at which the issuer can call the bond, None for a bond without a call."
      -}
    • addedInput schema / properties / country
      Added value: +{
      +  "default": "United States",
      +  "description": "For get_par_yield, get_forward_rate: The country, see `get_zero_coupon_curve`. For get_yield_curve_spread: The country, see `get_government_bond_yield_curve`.",
      +  "type": "string"
      +}
    • removedInput schema / properties / coupon_rate
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "items": {
      -        "type": "number"
      -      },
      -      "type": "array"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "Annual coupon rate as a decimal, e.g. 0.05 for 5 %. Leave unset to use the default of the indicator you selected. Defaults are 0.05 for get_key_rate_duration, get_option_adjusted_spread, get_yield_to_maturity, get_z_spread; None for get_duration, get_present_value, get_taylor_price_change."
      -}
    • addedInput schema / properties / date
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The day of the prices (YYYY-MM-DD)."
      +}
    • removedInput schema / properties / days_to_maturity
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "items": {
      -        "type": "number"
      -      },
      -      "type": "array"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The number of days until the instrument matures. If not provided, a range of typical T-bill maturities will be used."
      -}
    • removedInput schema / properties / discount_yield
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "items": {
      -        "type": "number"
      -      },
      -      "type": "array"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The money-market discount yield of the instrument (in decimal). If not provided, a range of discount yields will be used."
      -}
    • changedInput schema / properties / duration_type / description
      Previous value: -"The type of duration to calculate."New value: +"The duration: \"modified\", \"macaulay\", \"effective\" or \"dollar\"."
    • addedInput schema / properties / etfs
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "For collect_bond_statistics: The bond ETFs whose holdings to select bonds from, see `get_bond_universe`. For get_present_value, get_duration, get_yield_to_maturity, get_z_spread, get_key_rate_duration, get_taylor_price_change: The bond ETFs to select bonds from, see `get_bond_universe`. For get_bond_universe: The bond ETFs to read the holdings of, as a list or a comma-separated string. The holdings must name each bond as \"ISSUER COUPON% MM/DD/YYYY\" with a par amount, as iShares funds do."
      +}
    • changedInput schema / properties / far_maturity / description
      Previous value: -"The further maturity (or maturities), in years. If not provided, a range of far maturities will be used."New value: +"The further maturity (or maturities), in years or as labels such as '10Y'."
    • removedInput schema / properties / forward_rate
      Removed value: -{
      -  "default": 0.05,
      -  "description": "The forward rate as derived from the swap curve.",
      -  "type": "number"
      -}
    • removedInput schema / properties / frequency
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "integer"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "For get_duration, get_present_value: The frequency of coupon payments per year. For get_yield_to_maturity, get_par_yield, get_key_rate_duration, get_z_spread, get_taylor_price_change: The number of coupon payments per year. For get_option_adjusted_spread: The coupon payments per year. Leave unset to use the default of the indicator you selected. Defaults are 1 for get_duration, get_key_rate_duration, get_par_yield, get_present_value, get_taylor_price_change, get_yield_to_maturity, get_z_spread; 2 for get_option_adjusted_spread."
      -}
    • removedInput schema / properties / guess
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "For get_yield_to_maturity: The initial guess for the yield to maturity. For get_z_spread: The initial guess for the Z-spread. Leave unset to use the default of the indicator you selected. Defaults are 0.01 for get_z_spread; 0.05 for get_yield_to_maturity."
      -}
    • removedInput schema / properties / include_payoff
      Removed value: -{
      -  "default": false,
      -  "description": "True to include the payoff in the output, False otherwise.",
      -  "type": "boolean"
      -}
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_derivative_price",
      -  "get_duration",
      -  "get_present_value",
      -  "get_yield_to_maturity",
      -  "get_par_yield",
      -  "get_forward_rate",
      -  "get_breakeven_inflation_rate",
      -  "get_key_rate_duration",
      -  "get_yield_curve_spread",
      -  "get_z_spread",
      -  "get_option_adjusted_spread",
      -  "get_implied_default_probability",
      -  "get_bond_equivalent_yield",
      -  "get_taylor_price_change"
      -]New value: +[
      +  "collect_bond_statistics",
      +  "get_present_value",
      +  "get_duration",
      +  "get_yield_to_maturity",
      +  "get_z_spread",
      +  "get_key_rate_duration",
      +  "get_taylor_price_change",
      +  "get_bond_equivalent_yield",
      +  "get_par_yield",
      +  "get_forward_rate",
      +  "get_yield_curve_spread",
      +  "get_breakeven_inflation_rate",
      +  "get_implied_default_probability",
      +  "get_treasury_securities",
      +  "get_bond_universe"
      +]
    • removedInput schema / properties / is_receiver
      Removed value: -{
      -  "default": true,
      -  "description": "True if the holder is the receiver of the derivative, False if the holder is the payer.",
      -  "type": "boolean"
      -}
    • addedInput schema / properties / issuer
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "For collect_bond_statistics: Part of an issuer's name, such as \"Apple\", to select its bonds from the bond ETF holdings. For get_present_value, get_duration, get_yield_to_maturity, get_z_spread, get_key_rate_duration, get_taylor_price_change: Part of an issuer's name, such as \"Apple\". For get_bond_universe: Keeps the bonds whose issuer contains this text (case-insensitive), e.g. \"APPLE\" or \"JPMORGAN\", or any of several."
      +}
    • changedInput schema / properties / key_rate_maturity / description
      Previous value: -"The maturity (or maturities), in years, of the curve point(s) to shock. Must be present in the index of `spot_rates`."New value: +"The maturities of the Treasury curve to shock, in years or as labels such as '2Y' (one of the curve's maturities: 1M, 1.5M, 2M, 3M, 4M, 6M, 1Y, 2Y, 3Y, 5Y, 7Y, 10Y, 20Y and 30Y)."
    • changedInput schema / properties / long_maturity / description
      Previous value: -"The longer maturity (or maturities), in years. If not provided, a range of long maturities will be used."New value: +"The longer maturity (or maturities), in years or as labels such as '10Y'."
    • removedInput schema / properties / maturity
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "items": {
      -        "type": "number"
      -      },
      -      "type": "array"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The maturity (or maturities), in years, to calculate the breakeven inflation rate for. If not provided, a range of maturities will be used."
      -}
    • addedInput schema / properties / maturity_end
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "For collect_bond_statistics, get_present_value, get_duration, get_yield_to_maturity, get_z_spread, get_key_rate_duration, get_taylor_price_change: The latest maturity (YYYY-MM-DD). For get_bond_universe: Keeps the bonds maturing on or before this date (YYYY-MM-DD)."
      +}
    • addedInput schema / properties / maturity_start
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "For collect_bond_statistics, get_present_value, get_duration, get_yield_to_maturity, get_z_spread, get_key_rate_duration, get_taylor_price_change: The earliest maturity (YYYY-MM-DD). For get_bond_universe: Keeps the bonds maturing on or after this date (YYYY-MM-DD)."
      +}
    • removedInput schema / properties / max_iterations
      Removed value: -{
      -  "default": 100,
      -  "description": "The maximum number of iterations for convergence.",
      -  "type": "integer"
      -}
    • removedInput schema / properties / model
      Removed value: -{
      -  "default": "black",
      -  "description": "The type of model to use for calculating the derivative price.",
      -  "type": "string"
      -}
    • changedInput schema / properties / near_maturity / description
      Previous value: -"The nearer maturity (or maturities), in years. If not provided, a range of near maturities will be used."New value: +"The nearer maturity (or maturities), in years or as labels such as '6M'."
    • removedInput schema / properties / nominal_rates
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "additionalProperties": {
      -        "type": "number"
      -      },
      -      "type": "object"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The nominal (non-inflation-protected) yield curve in decimals, indexed by maturity in years (a number, or a label such as '6M' or '10Y')."
      -}
    • removedInput schema / properties / notional
      Removed value: -{
      -  "default": 10000000,
      -  "description": "The notional amount of the derivative.",
      -  "type": "number"
      -}
    • removedInput schema / properties / par_value
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The par value of the bond. Leave unset to use the default of the indicator you selected. Defaults are 100 for get_duration, get_key_rate_duration, get_par_yield, get_present_value, get_taylor_price_change, get_yield_to_maturity, get_z_spread; 100.0 for get_option_adjusted_spread."
      -}
    • removedInput schema / properties / payment_frequency
      Removed value: -{
      -  "default": 2,
      -  "description": "Number of fixed-leg payments per year on the underlying swap (e.g. 1 for annual, 2 for semi-annual, 4 for quarterly).",
      -  "type": "integer"
      -}
    • addedInput schema / properties / ratings
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The ratings: \"AAA\", \"AA\", \"A\", \"BBB\", \"BB\", \"B\" or \"CCC\", as a list or a comma-separated string."
      +}
    • removedInput schema / properties / real_rates
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "additionalProperties": {
      -        "type": "number"
      -      },
      -      "type": "object"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The real (inflation-protected) yield curve in decimals, indexed by maturity in years (a number, or a label such as '6M' or '10Y')."
      -}
    • changedInput schema / properties / recovery_rate / description
      Previous value: -"The share of the face value recovered on default."New value: +"The share of the face value recovered on default, the scenario the probabilities assume."
    • removedInput schema / properties / risk_free_rate
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The risk-free interest rate used to discount the swap's payment dates, read as a continuously compounded rate on a flat curve (discount factor exp(-r * t))."
      -}
    • addedInput schema / properties / security_type
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The kind of security: \"Bill\", \"Note\", \"Bond\", \"TIPS\" or \"FRN\", or several (a list or a comma-separated string)."
      +}
    • changedInput schema / properties / short_maturity / description
      Previous value: -"The shorter maturity (or maturities), in years. If not provided, a range of short maturities will be used."New value: +"The shorter maturity (or maturities), in years or as labels such as '3M'."
    • removedInput schema / properties / show_input_info
      Removed value: -{
      -  "default": true,
      -  "description": "For get_derivative_price: True to display input information, False otherwise. For get_duration, get_present_value, get_yield_to_maturity, get_par_yield, get_forward_rate, get_breakeven_inflation_rate, get_key_rate_duration, get_yield_curve_spread, get_z_spread, get_bond_equivalent_yield, get_taylor_price_change: Whether to display input information.",
      -  "type": "boolean"
      -}
    • removedInput schema / properties / spot_rates
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "additionalProperties": {
      -        "type": "number"
      -      },
      -      "type": "object"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The zero-coupon curve (annually compounded) by maturity in years."
      -}
    • removedInput schema / properties / spreads
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The credit spread as a decimal (0.01 for 100 basis points), or several by name as a dictionary, Series or string such as \"BBB:0.011, B:0.031\"."
      -}
    • removedInput schema / properties / strike_rate
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "items": {
      -        "type": "number"
      -      },
      -      "type": "array"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "Option strike price."
      -}
    • removedInput schema / properties / tenor
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "number"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The tenor (length in years) of the underlying swap."
      -}
    • removedInput schema / properties / tolerance
      Removed value: -{
      -  "default": 0.0001,
      -  "description": "The tolerance level for convergence.",
      -  "type": "number"
      -}
    • removedInput schema / properties / volatility
      Removed value: -{
      -  "default": 0.01,
      -  "description": "For get_derivative_price: The volatility of the underlying swap rate, quoted on the basis given by `volatility_type`. For get_option_adjusted_spread: The volatility of the short rate in absolute terms.",
      -  "type": "number"
      -}
    • removedInput schema / properties / volatility_type
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "default": null,
      -  "description": "The convention `volatility` is quoted on, either 'lognormal' (relative to the forward rate) or 'normal' (absolute, in rate units)."
      -}
    • removedInput schema / properties / years_to_first_call
      Removed value: -{
      -  "default": 2,
      -  "description": "The years until the bond can first be called.",
      -  "type": "number"
      -}
    • changedInput schema / properties / years_to_maturity / description
      Previous value: -"Years remaining until the bond matures. Leave unset to use the default of the indicator you selected. Defaults are None for get_derivative_price, get_duration, get_key_rate_duration, get_par_yield, get_present_value, get_taylor_price_change, get_yield_to_maturity, get_z_spread; 10.0 for get_option_adjusted_spread."New value: +"Years remaining until the bond matures."
    • changedInput schema / properties / yield_change / description
      Previous value: -"For get_key_rate_duration: The size of the shock applied to each key rate, up and down (in decimal). For get_taylor_price_change: The hypothetical change in yield to maturity, e.g. 0.01 for a 100 basis point increase. Leave unset to use the default of the indicator you selected. Defaults are 0.0001 for get_key_rate_duration; 0.01 for get_taylor_price_change."New value: +"For get_key_rate_duration: The shock to each key rate (decimal). For get_taylor_price_change: The change in the yield to maturity (decimal), negative for a fall. Leave unset to use the default of the indicator you selected. Defaults are 0.0001 for get_key_rate_duration; 0.01 for get_taylor_price_change."
    • removedInput schema / properties / yield_to_maturity
      Removed value: -{
      -  "default": 0.08,
      -  "description": "For get_duration, get_present_value: The yield to maturity of the bond. For get_taylor_price_change: The current yield to maturity of the bond.",
      -  "type": "number"
      -}
  3. Changed1 schema field changedv2.3.2
    • changedInput schema / properties / limit / description
      Previous value: -"The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. 0 returns every row."New value: +"The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead, and rows per ticker (an earnings calendar) are selected per ticker. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. 0 returns every row."
  4. Changed5 schema fields changedv2.3.1
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-10-27"New value: +""
    • changedInput schema / properties / end_date / description
      Previous value: -"End of the date range in YYYY-MM-DD format."New value: +"End of the date range in YYYY-MM-DD format; left empty, today (or the indicator's own window)."
    • changedInput schema / properties / limit / description
      Previous value: -"The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length."New value: +"The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length. 0 returns every row."
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-10-28"New value: +""
    • changedInput schema / properties / start_date / description
      Previous value: -"Start of the date range in YYYY-MM-DD format."New value: +"Start of the date range in YYYY-MM-DD format; left empty, five years before today (or the indicator's own window)."
  5. Changed24 schema fields changedv2.3.0
    • changedInput schema / properties / bond_price / description
      Previous value: -"Clean price of the bond per 100 face value."New value: +"Clean price of the bond per 100 face value. Leave unset to use the default of the indicator you selected. Defaults are None for get_yield_to_maturity, get_z_spread; 100.0 for get_option_adjusted_spread."
    • addedInput schema / properties / call_price
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": 100,
      +  "description": "The price at which the issuer can call the bond, None for a bond without a call."
      +}
    • changedInput schema / properties / coupon_rate / description
      Previous value: -"Annual coupon rate as a decimal, e.g. 0.05 for 5 %. Leave unset to use the default of the indicator you selected. Defaults are 0.05 for get_key_rate_duration, get_yield_to_maturity, get_z_spread; None for get_duration, get_present_value, get_taylor_price_change."New value: +"Annual coupon rate as a decimal, e.g. 0.05 for 5 %. Leave unset to use the default of the indicator you selected. Defaults are 0.05 for get_key_rate_duration, get_option_adjusted_spread, get_yield_to_maturity, get_z_spread; None for get_duration, get_present_value, get_taylor_price_change."
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-10-14"New value: +"2026-10-27"
    • addedInput schema / properties / frequency / anyOf
      Added value: +[
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / frequency / default
      Previous value: -1New value: +null
    • changedInput schema / properties / frequency / description
      Previous value: -"For get_duration, get_present_value: The frequency of coupon payments per year. For get_yield_to_maturity, get_par_yield, get_key_rate_duration, get_z_spread, get_taylor_price_change: The number of coupon payments per year."New value: +"For get_duration, get_present_value: The frequency of coupon payments per year. For get_yield_to_maturity, get_par_yield, get_key_rate_duration, get_z_spread, get_taylor_price_change: The number of coupon payments per year. For get_option_adjusted_spread: The coupon payments per year. Leave unset to use the default of the indicator you selected. Defaults are 1 for get_duration, get_key_rate_duration, get_par_yield, get_present_value, get_taylor_price_change, get_yield_to_maturity, get_z_spread; 2 for get_option_adjusted_spread."
    • removedInput schema / properties / frequency / type
      Removed value: -"integer"
    • addedInput schema / properties / horizons
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The horizons in years, as a list or a comma-separated string."
      +}
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_derivative_price",
      -  "get_duration",
      -  "get_present_value",
      -  "get_yield_to_maturity",
      -  "get_par_yield",
      -  "get_forward_rate",
      -  "get_breakeven_inflation_rate",
      -  "get_key_rate_duration",
      -  "get_yield_curve_spread",
      -  "get_z_spread",
      -  "get_bond_equivalent_yield",
      -  "get_taylor_price_change"
      -]New value: +[
      +  "get_derivative_price",
      +  "get_duration",
      +  "get_present_value",
      +  "get_yield_to_maturity",
      +  "get_par_yield",
      +  "get_forward_rate",
      +  "get_breakeven_inflation_rate",
      +  "get_key_rate_duration",
      +  "get_yield_curve_spread",
      +  "get_z_spread",
      +  "get_option_adjusted_spread",
      +  "get_implied_default_probability",
      +  "get_bond_equivalent_yield",
      +  "get_taylor_price_change"
      +]
    • changedInput schema / properties / nominal_rates / description
      Previous value: -"The nominal (non-inflation-protected) yield curve, indexed by maturity in years (in decimal)."New value: +"The nominal (non-inflation-protected) yield curve in decimals, indexed by maturity in years (a number, or a label such as '6M' or '10Y')."
    • addedInput schema / properties / par_value / anyOf
      Added value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / par_value / default
      Previous value: -100New value: +null
    • changedInput schema / properties / par_value / description
      Previous value: -"For get_duration, get_present_value, get_key_rate_duration, get_z_spread, get_taylor_price_change: The par value (face value) of the bond. For get_yield_to_maturity: The par value (face value) of the bond. This is the original price when it was issued by the issuer. For get_par_yield: The face value of the bond."New value: +"The par value of the bond. Leave unset to use the default of the indicator you selected. Defaults are 100 for get_duration, get_key_rate_duration, get_par_yield, get_present_value, get_taylor_price_change, get_yield_to_maturity, get_z_spread; 100.0 for get_option_adjusted_spread."
    • removedInput schema / properties / par_value / type
      Removed value: -"number"
    • changedInput schema / properties / real_rates / description
      Previous value: -"The real (inflation-protected) yield curve, indexed by maturity in years (in decimal)."New value: +"The real (inflation-protected) yield curve in decimals, indexed by maturity in years (a number, or a label such as '6M' or '10Y')."
    • addedInput schema / properties / recovery_rate
      Added value: +{
      +  "default": 0.4,
      +  "description": "The share of the face value recovered on default.",
      +  "type": "number"
      +}
    • changedInput schema / properties / risk_free_rate / description
      Previous value: -"The risk-free interest rate."New value: +"The risk-free interest rate used to discount the swap's payment dates, read as a continuously compounded rate on a flat curve (discount factor exp(-r * t))."
    • changedInput schema / properties / spot_rates / description
      Previous value: -"The yield curve, indexed by maturity in years (in decimal)."New value: +"The zero-coupon curve (annually compounded) by maturity in years."
    • addedInput schema / properties / spreads
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The credit spread as a decimal (0.01 for 100 basis points), or several by name as a dictionary, Series or string such as \"BBB:0.011, B:0.031\"."
      +}
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-10-15"New value: +"2021-10-28"
    • changedInput schema / properties / volatility / description
      Previous value: -"The volatility of the underlying swap rate, quoted on the basis given by `volatility_type`."New value: +"For get_derivative_price: The volatility of the underlying swap rate, quoted on the basis given by `volatility_type`. For get_option_adjusted_spread: The volatility of the short rate in absolute terms."
    • addedInput schema / properties / years_to_first_call
      Added value: +{
      +  "default": 2,
      +  "description": "The years until the bond can first be called.",
      +  "type": "number"
      +}
    • changedInput schema / properties / years_to_maturity / description
      Previous value: -"Years remaining until the bond matures."New value: +"Years remaining until the bond matures. Leave unset to use the default of the indicator you selected. Defaults are None for get_derivative_price, get_duration, get_key_rate_duration, get_par_yield, get_present_value, get_taylor_price_change, get_yield_to_maturity, get_z_spread; 10.0 for get_option_adjusted_spread."
  6. Changed93 schema fields changedv2.2.3
    • changedInput schema / properties / bond_price / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / bond_price / title
      Removed value: -"Bond Price"
    • addedInput schema / properties / countries / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  }
      +]
    • changedInput schema / properties / countries / description
      Previous value: -"Comma-separated country names, e.g. 'United States,Germany,Japan'."New value: +"Country names, comma-separated or as a list, e.g. 'United States,Germany,Japan'."
    • removedInput schema / properties / countries / title
      Removed value: -"Countries"
    • removedInput schema / properties / countries / type
      Removed value: -"string"
    • changedInput schema / properties / coupon_rate / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / coupon_rate / title
      Removed value: -"Coupon Rate"
    • changedInput schema / properties / days_to_maturity / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / days_to_maturity / description
      Previous value: -"Value for days_to_maturity."New value: +"The number of days until the instrument matures. If not provided, a range of typical T-bill maturities will be used."
    • removedInput schema / properties / days_to_maturity / title
      Removed value: -"Days To Maturity"
    • changedInput schema / properties / discount_yield / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / discount_yield / description
      Previous value: -"Value for discount_yield."New value: +"The money-market discount yield of the instrument (in decimal). If not provided, a range of discount yields will be used."
    • removedInput schema / properties / discount_yield / title
      Removed value: -"Discount Yield"
    • changedInput schema / properties / duration_type / description
      Previous value: -"Value for duration_type."New value: +"The type of duration to calculate."
    • removedInput schema / properties / duration_type / title
      Removed value: -"Duration Type"
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-10-02"New value: +"2026-10-14"
    • removedInput schema / properties / end_date / title
      Removed value: -"End Date"
    • changedInput schema / properties / far_maturity / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / far_maturity / description
      Previous value: -"Value for far_maturity."New value: +"The further maturity (or maturities), in years. If not provided, a range of far maturities will be used."
    • removedInput schema / properties / far_maturity / title
      Removed value: -"Far Maturity"
    • changedInput schema / properties / forward_rate / description
      Previous value: -"Value for forward_rate."New value: +"The forward rate as derived from the swap curve."
    • removedInput schema / properties / forward_rate / title
      Removed value: -"Forward Rate"
    • changedInput schema / properties / frequency / description
      Previous value: -"Value for frequency."New value: +"For get_duration, get_present_value: The frequency of coupon payments per year. For get_yield_to_maturity, get_par_yield, get_key_rate_duration, get_z_spread, get_taylor_price_change: The number of coupon payments per year."
    • removedInput schema / properties / frequency / title
      Removed value: -"Frequency"
    • changedInput schema / properties / guess / description
      Previous value: -"Value for guess. Leave unset to use the default of the indicator you selected. Defaults are 0.01 for get_z_spread; 0.05 for get_yield_to_maturity."New value: +"For get_yield_to_maturity: The initial guess for the yield to maturity. For get_z_spread: The initial guess for the Z-spread. Leave unset to use the default of the indicator you selected. Defaults are 0.01 for get_z_spread; 0.05 for get_yield_to_maturity."
    • removedInput schema / properties / guess / title
      Removed value: -"Guess"
    • changedInput schema / properties / include_payoff / description
      Previous value: -"Value for include_payoff."New value: +"True to include the payoff in the output, False otherwise."
    • removedInput schema / properties / include_payoff / title
      Removed value: -"Include Payoff"
    • changedInput schema / properties / indicator / description
      Previous value: -"Name of the specific metric to calculate, e.g. 'get_asset_turnover_ratio'. Required — omitting it returns the list of available indicators."New value: +"Name of the specific metric to calculate, one of the listed values. Required — search_metrics finds the indicator (and its tool) for a metric by name."
    • removedInput schema / properties / indicator / title
      Removed value: -"Indicator"
    • changedInput schema / properties / is_receiver / description
      Previous value: -"Value for is_receiver."New value: +"True if the holder is the receiver of the derivative, False if the holder is the payer."
    • removedInput schema / properties / is_receiver / title
      Removed value: -"Is Receiver"
    • changedInput schema / properties / key_rate_maturity / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / key_rate_maturity / description
      Previous value: -"Value for key_rate_maturity."New value: +"The maturity (or maturities), in years, of the curve point(s) to shock. Must be present in the index of `spot_rates`."
    • removedInput schema / properties / key_rate_maturity / title
      Removed value: -"Key Rate Maturity"
    • addedInput schema / properties / limit
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The rows to return, like head and tail: 5 for the first five, -5 for the last five (the most recent of a time series). A table with its periods as columns (financial statements, ratios) keeps its first or last periods instead. For ETF holdings the largest (or, negative, the smallest) by weight, and for a list (e.g. news or a screener) its length."
      +}
    • changedInput schema / properties / long_maturity / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / long_maturity / description
      Previous value: -"Value for long_maturity."New value: +"The longer maturity (or maturities), in years. If not provided, a range of long maturities will be used."
    • removedInput schema / properties / long_maturity / title
      Removed value: -"Long Maturity"
    • changedInput schema / properties / maturity / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / maturity / description
      Previous value: -"Value for maturity."New value: +"The maturity (or maturities), in years, to calculate the breakeven inflation rate for. If not provided, a range of maturities will be used."
    • removedInput schema / properties / maturity / title
      Removed value: -"Maturity"
    • changedInput schema / properties / max_iterations / description
      Previous value: -"Value for max_iterations."New value: +"The maximum number of iterations for convergence."
    • removedInput schema / properties / max_iterations / title
      Removed value: -"Max Iterations"
    • changedInput schema / properties / model / description
      Previous value: -"Value for model."New value: +"The type of model to use for calculating the derivative price."
    • removedInput schema / properties / model / title
      Removed value: -"Model"
    • changedInput schema / properties / near_maturity / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / near_maturity / description
      Previous value: -"Value for near_maturity."New value: +"The nearer maturity (or maturities), in years. If not provided, a range of near maturities will be used."
    • removedInput schema / properties / near_maturity / title
      Removed value: -"Near Maturity"
    • changedInput schema / properties / nominal_rates / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {
      +      "type": "number"
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / nominal_rates / description
      Previous value: -"Value for nominal_rates."New value: +"The nominal (non-inflation-protected) yield curve, indexed by maturity in years (in decimal)."
    • removedInput schema / properties / nominal_rates / title
      Removed value: -"Nominal Rates"
    • changedInput schema / properties / notional / description
      Previous value: -"Value for notional."New value: +"The notional amount of the derivative."
    • removedInput schema / properties / notional / title
      Removed value: -"Notional"
    • changedInput schema / properties / par_value / description
      Previous value: -"Value for par_value."New value: +"For get_duration, get_present_value, get_key_rate_duration, get_z_spread, get_taylor_price_change: The par value (face value) of the bond. For get_yield_to_maturity: The par value (face value) of the bond. This is the original price when it was issued by the issuer. For get_par_yield: The face value of the bond."
    • removedInput schema / properties / par_value / title
      Removed value: -"Par Value"
    • changedInput schema / properties / payment_frequency / description
      Previous value: -"Value for payment_frequency."New value: +"Number of fixed-leg payments per year on the underlying swap (e.g. 1 for annual, 2 for semi-annual, 4 for quarterly)."
    • removedInput schema / properties / payment_frequency / title
      Removed value: -"Payment Frequency"
    • removedInput schema / properties / quarterly / title
      Removed value: -"Quarterly"
    • changedInput schema / properties / real_rates / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {
      +      "type": "number"
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / real_rates / description
      Previous value: -"Value for real_rates."New value: +"The real (inflation-protected) yield curve, indexed by maturity in years (in decimal)."
    • removedInput schema / properties / real_rates / title
      Removed value: -"Real Rates"
    • changedInput schema / properties / risk_free_rate / description
      Previous value: -"Value for risk_free_rate."New value: +"The risk-free interest rate."
    • removedInput schema / properties / risk_free_rate / title
      Removed value: -"Risk Free Rate"
    • changedInput schema / properties / short_maturity / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / short_maturity / description
      Previous value: -"Value for short_maturity."New value: +"The shorter maturity (or maturities), in years. If not provided, a range of short maturities will be used."
    • removedInput schema / properties / short_maturity / title
      Removed value: -"Short Maturity"
    • removedInput schema / properties / show_columns / title
      Removed value: -"Show Columns"
    • changedInput schema / properties / show_input_info / description
      Previous value: -"Value for show_input_info."New value: +"For get_derivative_price: True to display input information, False otherwise. For get_duration, get_present_value, get_yield_to_maturity, get_par_yield, get_forward_rate, get_breakeven_inflation_rate, get_key_rate_duration, get_yield_curve_spread, get_z_spread, get_bond_equivalent_yield, get_taylor_price_change: Whether to display input information."
    • removedInput schema / properties / show_input_info / title
      Removed value: -"Show Input Info"
    • changedInput schema / properties / spot_rates / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {
      +      "type": "number"
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / spot_rates / description
      Previous value: -"Value for spot_rates."New value: +"The yield curve, indexed by maturity in years (in decimal)."
    • removedInput schema / properties / spot_rates / title
      Removed value: -"Spot Rates"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-10-03"New value: +"2021-10-15"
    • removedInput schema / properties / start_date / title
      Removed value: -"Start Date"
    • changedInput schema / properties / strike_rate / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / strike_rate / title
      Removed value: -"Strike Rate"
    • changedInput schema / properties / tenor / description
      Previous value: -"Value for tenor."New value: +"The tenor (length in years) of the underlying swap."
    • removedInput schema / properties / tenor / title
      Removed value: -"Tenor"
    • changedInput schema / properties / tolerance / description
      Previous value: -"Value for tolerance."New value: +"The tolerance level for convergence."
    • removedInput schema / properties / tolerance / title
      Removed value: -"Tolerance"
    • changedInput schema / properties / volatility / description
      Previous value: -"Value for volatility."New value: +"The volatility of the underlying swap rate, quoted on the basis given by `volatility_type`."
    • removedInput schema / properties / volatility / title
      Removed value: -"Volatility"
    • changedInput schema / properties / volatility_type / description
      Previous value: -"Value for volatility_type."New value: +"The convention `volatility` is quoted on, either 'lognormal' (relative to the forward rate) or 'normal' (absolute, in rate units)."
    • removedInput schema / properties / volatility_type / title
      Removed value: -"Volatility Type"
    • changedInput schema / properties / years_to_maturity / anyOf
      Previous value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "items": {
      +      "type": "number"
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedInput schema / properties / years_to_maturity / title
      Removed value: -"Years To Maturity"
    • changedInput schema / properties / yield_change / description
      Previous value: -"Value for yield_change. Leave unset to use the default of the indicator you selected. Defaults are 0.0001 for get_key_rate_duration; 0.01 for get_taylor_price_change."New value: +"For get_key_rate_duration: The size of the shock applied to each key rate, up and down (in decimal). For get_taylor_price_change: The hypothetical change in yield to maturity, e.g. 0.01 for a 100 basis point increase. Leave unset to use the default of the indicator you selected. Defaults are 0.0001 for get_key_rate_duration; 0.01 for get_taylor_price_change."
    • removedInput schema / properties / yield_change / title
      Removed value: -"Yield Change"
    • changedInput schema / properties / yield_to_maturity / description
      Previous value: -"Value for yield_to_maturity."New value: +"For get_duration, get_present_value: The yield to maturity of the bond. For get_taylor_price_change: The current yield to maturity of the bond."
    • removedInput schema / properties / yield_to_maturity / title
      Removed value: -"Yield To Maturity"
    • removedInput schema / title
      Removed value: -"fixed_incomeArguments"
  7. Changed2 schema fields changedv2.2.1
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-08-19"New value: +"2026-10-02"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-08-20"New value: +"2021-10-03"
  8. Changed21 schema fields changedv2.2.0
    • changedInput schema / properties / coupon_rate / description
      Previous value: -"Annual coupon rate as a decimal, e.g. 0.05 for 5 %."New value: +"Annual coupon rate as a decimal, e.g. 0.05 for 5 %. Leave unset to use the default of the indicator you selected. Defaults are 0.05 for get_key_rate_duration, get_yield_to_maturity, get_z_spread; None for get_duration, get_present_value, get_taylor_price_change."
    • addedInput schema / properties / days_to_maturity
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for days_to_maturity.",
      +  "title": "Days To Maturity"
      +}
    • addedInput schema / properties / discount_yield
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for discount_yield.",
      +  "title": "Discount Yield"
      +}
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-07-14"New value: +"2026-08-19"
    • addedInput schema / properties / far_maturity
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for far_maturity.",
      +  "title": "Far Maturity"
      +}
    • addedInput schema / properties / guess / anyOf
      Added value: +[
      +  {
      +    "type": "number"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / guess / default
      Previous value: -0.05New value: +null
    • changedInput schema / properties / guess / description
      Previous value: -"Value for guess."New value: +"Value for guess. Leave unset to use the default of the indicator you selected. Defaults are 0.01 for get_z_spread; 0.05 for get_yield_to_maturity."
    • removedInput schema / properties / guess / type
      Removed value: -"number"
    • changedInput schema / properties / indicator / enum
      Previous value: -[
      -  "get_derivative_price",
      -  "get_duration",
      -  "get_present_value",
      -  "get_yield_to_maturity"
      -]New value: +[
      +  "get_derivative_price",
      +  "get_duration",
      +  "get_present_value",
      +  "get_yield_to_maturity",
      +  "get_par_yield",
      +  "get_forward_rate",
      +  "get_breakeven_inflation_rate",
      +  "get_key_rate_duration",
      +  "get_yield_curve_spread",
      +  "get_z_spread",
      +  "get_bond_equivalent_yield",
      +  "get_taylor_price_change"
      +]
    • addedInput schema / properties / key_rate_maturity
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for key_rate_maturity.",
      +  "title": "Key Rate Maturity"
      +}
    • addedInput schema / properties / long_maturity
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for long_maturity.",
      +  "title": "Long Maturity"
      +}
    • addedInput schema / properties / maturity
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for maturity.",
      +  "title": "Maturity"
      +}
    • addedInput schema / properties / near_maturity
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for near_maturity.",
      +  "title": "Near Maturity"
      +}
    • addedInput schema / properties / nominal_rates
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for nominal_rates.",
      +  "title": "Nominal Rates"
      +}
    • addedInput schema / properties / real_rates
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for real_rates.",
      +  "title": "Real Rates"
      +}
    • addedInput schema / properties / short_maturity
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for short_maturity.",
      +  "title": "Short Maturity"
      +}
    • addedInput schema / properties / spot_rates
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for spot_rates.",
      +  "title": "Spot Rates"
      +}
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-07-15"New value: +"2021-08-20"
    • addedInput schema / properties / volatility_type
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for volatility_type.",
      +  "title": "Volatility Type"
      +}
    • addedInput schema / properties / yield_change
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for yield_change. Leave unset to use the default of the indicator you selected. Defaults are 0.0001 for get_key_rate_duration; 0.01 for get_taylor_price_change.",
      +  "title": "Yield Change"
      +}
  9. Changed4 schema fields changed
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-07-09"New value: +"2026-07-14"
    • addedInput schema / properties / payment_frequency
      Added value: +{
      +  "default": 2,
      +  "description": "Value for payment_frequency.",
      +  "title": "Payment Frequency",
      +  "type": "integer"
      +}
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-07-10"New value: +"2021-07-15"
    • addedInput schema / properties / tenor
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Value for tenor.",
      +  "title": "Tenor"
      +}
  10. Changed2 schema fields changedv2.1.4
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-06-27"New value: +"2026-07-09"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-06-28"New value: +"2021-07-10"
  11. Changed2 schema fields changedv2.1.3
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-06-23"New value: +"2026-06-27"
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-06-24"New value: +"2021-06-28"
  12. Changed3 schema fields changedv0.1.2
    • changedInput schema / properties / end_date / default
      Previous value: -"2026-06-22"New value: +"2026-06-23"
    • addedInput schema / properties / show_columns
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Comma-separated names to filter the output. For historical data use the key names visible in any response record (e.g. 'Close,Volume,Return'). For financial statements use the 'metric' field values from the response (e.g. 'Revenue,Net Income,EBITDA'). Call the tool once without this parameter to see all available names, then repeat with show_columns to reduce response size and token usage.",
      +  "title": "Show Columns"
      +}
    • changedInput schema / properties / start_date / default
      Previous value: -"2021-06-23"New value: +"2021-06-24"
  13. Addedv0.1.1

TDQS

A3.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnly/idempotent annotations, the description discloses substantial operational context: issuer filtering needs a FinancialModelingPrep API key and only has latest prices, get_implied_default_probability needs a FRED API key, TIPS carry real yields with no present value or Z-spread on the nominal curve, floating rate notes are excluded, weekend/holiday dates roll back to the prior business day, and callable bonds yield less to the call date. It also pins down quoting conventions (semi-annual bond-equivalent decimals, clean prices per 100 of par).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The content is one dense, unbroken paragraph of roughly 600 words covering nineteen indicators, with no headings, bullets, or grouping. Facts are packed efficiently at sentence level, but an agent must scan the whole block to find the two sentences about the indicator it needs, which is poor front-loading for a tool this broad.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 33 parameters, 19 sub-operations, and an output schema that already documents return shape, the description is unusually complete: it names data sources (FedInvest, ETF holdings, ICE BofA, Freddie Mac), the exclusions and conventions, and the specific parameter each indicator responds to. What it lacks is organization and an explicit mapping of every parameter to its indicator, which the schema descriptions partially cover.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema coverage the baseline is 3, but the description adds real meaning on top of the schema: Treasury CUSIPs 'start with 912', maturity_start/maturity_end 'alone select every Treasury bill, note and bond maturing in between', no spread is returned outside an issuer's own maturity range, and worked examples ('APPLE INC,BOEING,FORD MOTOR CREDIT,INTEL' with maturity_years='4.5', e.g. '10Y-2Y' for the spread). Some of this repeats schema defaults, but the interplay between parameters is only explained here.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening states a specific domain ('Bond calculations on real bonds and market curves') and then enumerates the nineteen concrete operations behind `indicator` (collect_bond_statistics, get_z_spread, get_issuer_spreads, get_amortization_schedule, etc.), so an agent can map a task to a sub-command. It does not, however, distinguish this tool from curve/rate siblings such as `government` or `rates`, leaving the boundary to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage context is implied rather than routed: the description explains default behavior ('Without arguments they use the benchmark US Treasuries') and how to narrow results ('narrow it with issuer=, bonds=, maturity_start=...'), and notes that `from_date=` is used 'instead of yield_change='. There is no explicit statement of when to pick this tool over a sibling tool or when a given indicator is inappropriate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.