Skip to content
HALOWERK

Finopswerk

own credit liability fair value split

Reconstructs one issuer financial liability designated at FVTPL with own-credit effects in OCI and all other effects in P&L, from three end-of-period cash flows (the first paid at valuation), a caller-supplied period-start market IRR, opening benchmark b0 and closing benchmark b1. Spread s = IRR - b0; counterfactual closing rate k = b1 + s; benchmark-only closing FV = CF2/(1+k) + CF3/(1+k)^2. Returns 24 exact fractions. It does not solve or calibrate the IRR.

POST https://finops.halowerk.com/v1/own-credit-liability-fair-value-split

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
cashflows_narrayYes
period_start_irr_bpintegerYes
benchmark_open_bpintegerYes
benchmark_close_bpintegerYes
observed_close_fv_nintegerYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "required": [
    "cashflows_n",
    "period_start_irr_bp",
    "benchmark_open_bp",
    "benchmark_close_bp",
    "observed_close_fv_n",
    "amount_denominator",
    "report"
  ],
  "properties": {
    "cashflows_n": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      },
      "minItems": 3,
      "maxItems": 3
    },
    "period_start_irr_bp": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "benchmark_open_bp": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "benchmark_close_bp": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "observed_close_fv_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 24,
      "maxProperties": 24,
      "propertyNames": {
        "enum": [
          "cashflow1",
          "cashflow2",
          "cashflow3",
          "period_start_irr",
          "opening_benchmark",
          "closing_benchmark",
          "initial_credit_spread",
          "updated_counterfactual_rate",
          "opening_fair_value",
          "first_cash_paid",
          "start_rate_accretion_component",
          "post_cash_unchanged_rate_value",
          "benchmark_only_closing_value",
          "observed_closing_fair_value",
          "benchmark_PL_expense",
          "total_PL_expense",
          "own_credit_OCI_expense",
          "total_comprehensive_expense",
          "own_credit_OCI_gain_loss",
          "total_PL_gain_loss",
          "closing_liability",
          "liability_bridge_gap",
          "component_bridge_gap",
          "spread_rate_bridge_gap"
        ]
      },
      "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
          }
        }
      }
    }
  },
  "additionalProperties": false
}

Open original schema

Published input example

{
  "cashflows_n": [
    5,
    5,
    105
  ],
  "period_start_irr_bp": 500,
  "benchmark_open_bp": 200,
  "benchmark_close_bp": 300,
  "observed_close_fv_n": 90,
  "amount_denominator": 1,
  "report": {
    "cashflow1": {
      "n": "5",
      "d": "1"
    },
    "cashflow2": {
      "n": "5",
      "d": "1"
    },
    "cashflow3": {
      "n": "105",
      "d": "1"
    },
    "period_start_irr": {
      "n": "1",
      "d": "20"
    },
    "opening_benchmark": {
      "n": "1",
      "d": "50"
    },
    "closing_benchmark": {
      "n": "3",
      "d": "100"
    },
    "initial_credit_spread": {
      "n": "3",
      "d": "100"
    },
    "updated_counterfactual_rate": {
      "n": "3",
      "d": "50"
    },
    "opening_fair_value": {
      "n": "100",
      "d": "1"
    },
    "first_cash_paid": {
      "n": "5",
      "d": "1"
    },
    "start_rate_accretion_component": {
      "n": "5",
      "d": "1"
    },
    "post_cash_unchanged_rate_value": {
      "n": "100",
      "d": "1"
    },
    "benchmark_only_closing_value": {
      "n": "275750",
      "d": "2809"
    },
    "observed_closing_fair_value": {
      "n": "90",
      "d": "1"
    },
    "benchmark_PL_expense": {
      "n": "-5150",
      "d": "2809"
    },
    "total_PL_expense": {
      "n": "8895",
      "d": "2809"
    },
    "own_credit_OCI_expense": {
      "n": "-22940",
      "d": "2809"
    },
    "total_comprehensive_expense": {
      "n": "-5",
      "d": "1"
    },
    "own_credit_OCI_gain_loss": {
      "n": "22940",
      "d": "2809"
    },
    "total_PL_gain_loss": {
      "n": "-8895",
      "d": "2809"
    },
    "closing_liability": {
      "n": "90",
      "d": "1"
    },
    "liability_bridge_gap": {
      "n": "0",
      "d": "1"
    },
    "component_bridge_gap": {
      "n": "0",
      "d": "1"
    },
    "spread_rate_bridge_gap": {
      "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 โ†’