Skip to content
HALOWERK

Finopswerk

fvoci debt disposal recycling ledger

Reconstructs one caller-qualified debt asset at fair value through other comprehensive income over two annual coupons and a complete cash sale right after the second. Inputs: initial cost (equal to initial FV, no fees), a constant annual EIR, two cash coupons, ex-coupon FV after year 1 and sale proceeds. Tracks amortized cost, carrying FV, the OCI reserve (FV minus AC) and full recycling of the cumulative reserve to P&L on disposal. Returns 24 exact fractions.

POST https://finops.halowerk.com/v1/fvoci-debt-disposal-recycling-ledger

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
initial_cost_nintegerYes
annual_eir_bpsintegerYes
coupons_narrayYes
holding_fair_value_nintegerYes
sale_proceeds_nintegerYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "required": [
    "initial_cost_n",
    "annual_eir_bps",
    "coupons_n",
    "holding_fair_value_n",
    "sale_proceeds_n",
    "amount_denominator",
    "report"
  ],
  "properties": {
    "initial_cost_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "annual_eir_bps": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "coupons_n": {
      "type": "array",
      "minItems": 2,
      "maxItems": 2,
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      }
    },
    "holding_fair_value_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "sale_proceeds_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 24,
      "maxProperties": 24,
      "propertyNames": {
        "enum": [
          "initial_cost",
          "annual_eir",
          "coupon_1",
          "coupon_2",
          "interest_1",
          "interest_2",
          "ac_after_1",
          "ac_before_sale",
          "holding_fair_value",
          "oci_after_1",
          "oci_change_to_sale",
          "oci_before_recycling",
          "recycling_PL",
          "oci_reclassification",
          "closing_oci",
          "interest_total",
          "sale_cash",
          "coupon_cash_total",
          "net_cash_gain",
          "total_PL",
          "net_OCI_change",
          "asset_after_sale",
          "holding_balance_gap",
          "lifetime_cash_PL_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

{
  "initial_cost_n": 1000,
  "annual_eir_bps": 1000,
  "coupons_n": [
    100,
    100
  ],
  "holding_fair_value_n": 1050,
  "sale_proceeds_n": 1100,
  "amount_denominator": 1,
  "report": {
    "initial_cost": {
      "n": "1000",
      "d": "1"
    },
    "annual_eir": {
      "n": "1",
      "d": "10"
    },
    "coupon_1": {
      "n": "100",
      "d": "1"
    },
    "coupon_2": {
      "n": "100",
      "d": "1"
    },
    "interest_1": {
      "n": "100",
      "d": "1"
    },
    "interest_2": {
      "n": "100",
      "d": "1"
    },
    "ac_after_1": {
      "n": "1000",
      "d": "1"
    },
    "ac_before_sale": {
      "n": "1000",
      "d": "1"
    },
    "holding_fair_value": {
      "n": "1050",
      "d": "1"
    },
    "oci_after_1": {
      "n": "50",
      "d": "1"
    },
    "oci_change_to_sale": {
      "n": "50",
      "d": "1"
    },
    "oci_before_recycling": {
      "n": "100",
      "d": "1"
    },
    "recycling_PL": {
      "n": "100",
      "d": "1"
    },
    "oci_reclassification": {
      "n": "-100",
      "d": "1"
    },
    "closing_oci": {
      "n": "0",
      "d": "1"
    },
    "interest_total": {
      "n": "200",
      "d": "1"
    },
    "sale_cash": {
      "n": "1100",
      "d": "1"
    },
    "coupon_cash_total": {
      "n": "200",
      "d": "1"
    },
    "net_cash_gain": {
      "n": "300",
      "d": "1"
    },
    "total_PL": {
      "n": "300",
      "d": "1"
    },
    "net_OCI_change": {
      "n": "0",
      "d": "1"
    },
    "asset_after_sale": {
      "n": "0",
      "d": "1"
    },
    "holding_balance_gap": {
      "n": "0",
      "d": "1"
    },
    "lifetime_cash_PL_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 โ†’