Skip to content
HALOWERK

Finopswerk

liability effective rate bracket certificate

Inverts the present-value equation of one fixed financial liability from the caller's initial amortized cost and three fixed year-end cash outflows. Returns an exact rational certificate enclosing the unique annual effective interest rate within one basis point, not a rounded rate claimed as the exact EIR. Domain 0..100% annual on 10001 ticks (0..10000 bps); it requires PV(0) >= initial >= PV(100%), otherwise HTTP 400. Returns 24 scalars.

POST https://finops.halowerk.com/v1/liability-effective-rate-bracket-certificate

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
initial_amortized_cost_nintegerYes
payments_narrayYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "properties": {
    "initial_amortized_cost_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "payments_n": {
      "type": "array",
      "minItems": 3,
      "maxItems": 3,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      }
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 24,
      "maxProperties": 24,
      "propertyNames": {
        "enum": [
          "initial_amortized_cost",
          "future_cash_total",
          "lower_rate_bps",
          "upper_rate_bps",
          "lower_rate",
          "upper_rate",
          "width_bps",
          "exact_grid_root",
          "lower_pv_0",
          "lower_pv_1",
          "lower_pv_2",
          "upper_pv_0",
          "upper_pv_1",
          "upper_pv_2",
          "pv_at_lower",
          "pv_at_upper",
          "lower_pv_gap",
          "upper_pv_gap",
          "zero_rate_gap",
          "hundred_percent_rate_gap",
          "total_undiscounted_excess",
          "terminal_trial_residual_lower",
          "terminal_trial_residual_upper",
          "time0_valuation_amount_signed"
        ]
      },
      "additionalProperties": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "n",
          "d"
        ],
        "properties": {
          "n": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 64
          },
          "d": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 64
          }
        }
      }
    }
  },
  "required": [
    "initial_amortized_cost_n",
    "payments_n",
    "amount_denominator",
    "report"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "initial_amortized_cost_n": 3,
  "payments_n": [
    0,
    0,
    5
  ],
  "amount_denominator": 1,
  "report": {
    "initial_amortized_cost": {
      "n": "3",
      "d": "1"
    },
    "future_cash_total": {
      "n": "5",
      "d": "1"
    },
    "lower_rate_bps": {
      "n": "1856",
      "d": "1"
    },
    "upper_rate_bps": {
      "n": "1857",
      "d": "1"
    },
    "lower_rate": {
      "n": "116",
      "d": "625"
    },
    "upper_rate": {
      "n": "1857",
      "d": "10000"
    },
    "width_bps": {
      "n": "1",
      "d": "1"
    },
    "exact_grid_root": {
      "n": "0",
      "d": "1"
    },
    "lower_pv_0": {
      "n": "0",
      "d": "1"
    },
    "lower_pv_1": {
      "n": "0",
      "d": "1"
    },
    "lower_pv_2": {
      "n": "1220703125",
      "d": "406869021"
    },
    "upper_pv_0": {
      "n": "0",
      "d": "1"
    },
    "upper_pv_1": {
      "n": "0",
      "d": "1"
    },
    "upper_pv_2": {
      "n": "5000000000000",
      "d": "1666957239793"
    },
    "pv_at_lower": {
      "n": "1220703125",
      "d": "406869021"
    },
    "pv_at_upper": {
      "n": "5000000000000",
      "d": "1666957239793"
    },
    "lower_pv_gap": {
      "n": "96062",
      "d": "406869021"
    },
    "upper_pv_gap": {
      "n": "-871719379",
      "d": "1666957239793"
    },
    "zero_rate_gap": {
      "n": "2",
      "d": "1"
    },
    "hundred_percent_rate_gap": {
      "n": "-19",
      "d": "8"
    },
    "total_undiscounted_excess": {
      "n": "2",
      "d": "1"
    },
    "terminal_trial_residual_lower": {
      "n": "-96062",
      "d": "244140625"
    },
    "terminal_trial_residual_upper": {
      "n": "871719379",
      "d": "1000000000000"
    },
    "time0_valuation_amount_signed": {
      "n": "-3",
      "d": "1"
    }
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’