Skip to content
HALOWERK

Finopswerk

financial guarantee fee floor ledger

Reconstructs one issuer non-FVTPL financial guarantee under the higher-of fee-floor/ECL model over four equal years of stand-ready coverage. The opening liability equals the caller-established initial fair value/upfront premium F, with straight-line income F/4 per year. At the ends of years 1, 2 and 3 the liability = max(caller Section 5.5 ECL, initial FV minus cumulative income), never the sum of ECL and unamortized fee. Returns 23 exact scalars.

POST https://finops.halowerk.com/v1/financial-guarantee-fee-floor-ledger

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
initial_fee_fv_nintegerYes
ecl_estimates_narrayYes
capture_indexintegerYes
captured_ecl_domain_narrayYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "properties": {
    "initial_fee_fv_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "ecl_estimates_n": {
      "type": "array",
      "minItems": 3,
      "maxItems": 3,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      }
    },
    "capture_index": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2
    },
    "captured_ecl_domain_n": {
      "type": "array",
      "minItems": 1,
      "maxItems": 2,
      "uniqueItems": true,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      }
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 23,
      "maxProperties": 23,
      "propertyNames": {
        "enum": [
          "initial_guarantee_liability",
          "annual_fee_income",
          "unamortized_fee_floor_0",
          "unamortized_fee_floor_1",
          "unamortized_fee_floor_2",
          "closing_liability_0",
          "closing_liability_1",
          "closing_liability_2",
          "liability_above_floor_0",
          "liability_above_floor_1",
          "liability_above_floor_2",
          "excess_over_floor_change_0",
          "excess_over_floor_change_1",
          "excess_over_floor_change_2",
          "net_PL_0",
          "net_PL_1",
          "net_PL_2",
          "cumulative_net_PL_0",
          "cumulative_net_PL_1",
          "cumulative_net_PL_2",
          "liability_bridge_gap_0",
          "liability_bridge_gap_1",
          "liability_bridge_gap_2"
        ]
      },
      "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_fee_fv_n",
    "ecl_estimates_n",
    "capture_index",
    "captured_ecl_domain_n",
    "amount_denominator",
    "report"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "initial_fee_fv_n": 7,
  "ecl_estimates_n": [
    1,
    2,
    6
  ],
  "capture_index": 1,
  "captured_ecl_domain_n": [
    2
  ],
  "amount_denominator": 3,
  "report": {
    "initial_guarantee_liability": {
      "n": "7",
      "d": "3"
    },
    "annual_fee_income": {
      "n": "7",
      "d": "12"
    },
    "unamortized_fee_floor_0": {
      "n": "7",
      "d": "4"
    },
    "unamortized_fee_floor_1": {
      "n": "7",
      "d": "6"
    },
    "unamortized_fee_floor_2": {
      "n": "7",
      "d": "12"
    },
    "closing_liability_0": {
      "n": "7",
      "d": "4"
    },
    "closing_liability_1": {
      "n": "7",
      "d": "6"
    },
    "closing_liability_2": {
      "n": "2",
      "d": "1"
    },
    "liability_above_floor_0": {
      "n": "0",
      "d": "1"
    },
    "liability_above_floor_1": {
      "n": "0",
      "d": "1"
    },
    "liability_above_floor_2": {
      "n": "17",
      "d": "12"
    },
    "excess_over_floor_change_0": {
      "n": "0",
      "d": "1"
    },
    "excess_over_floor_change_1": {
      "n": "0",
      "d": "1"
    },
    "excess_over_floor_change_2": {
      "n": "17",
      "d": "12"
    },
    "net_PL_0": {
      "n": "7",
      "d": "12"
    },
    "net_PL_1": {
      "n": "7",
      "d": "12"
    },
    "net_PL_2": {
      "n": "-5",
      "d": "6"
    },
    "cumulative_net_PL_0": {
      "n": "7",
      "d": "12"
    },
    "cumulative_net_PL_1": {
      "n": "7",
      "d": "6"
    },
    "cumulative_net_PL_2": {
      "n": "1",
      "d": "3"
    },
    "liability_bridge_gap_0": {
      "n": "0",
      "d": "1"
    },
    "liability_bridge_gap_1": {
      "n": "0",
      "d": "1"
    },
    "liability_bridge_gap_2": {
      "n": "0",
      "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 โ†’