cashflow_analytics.convexity
****************************

spice.cashflow_analytics.convexity(cashflows: Series, yield_rate: float = 0.08, valuation_date: date | None = None, day_count_convention: str = 'ACT_365', compounding_frequency: Literal['annual', 'semi_annual'] = 'annual') -> float

   Calculate convexity of cashflows.

   Convexity measures the curvature of price-yield relationship.
   Formula: Sum of (C_t * (t^2 + t)) / (1 + y)^(t+2) / Present_Value

   Parameters:
      * **cashflows** -- Series with date index and cashflow amounts
        as values

      * **yield_rate** -- Yield rate to consider (usually estimated
        yield as of the valuation date)

      * **valuation_date** -- Date to value cashflows from (defaults
        to today)

      * **day_count_convention** -- Day counting method

      * **compounding_frequency** -- Frequency of discount rate
        compounding ("annual" or "semi_annual")

   Returns:
      Convexity measure
