Skip to content
HALOWERK

Finopswerk

finite loss capital allocation euler certificate

Computes exact Expected Shortfall capital allocation for one fixed joint finite loss table with 2..3 books, 2..4 positive-probability states and an explicit tail mass beta. Aggregate L = sum of books; ES = max q.L with sum q = 1, 0 <= q <= p/beta. Returns all optimal weight-polytope vertices, their capital vectors C_i = q.X_i, the threshold and primal/dual/complementarity certificates. Classical Euler allocation applies only if the capital face is a singleton.

POST https://finops.halowerk.com/v1/finite-loss-capital-allocation-euler-certificate

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
problemSee schemaYes
Show full input schema
{
  "type": "object",
  "required": [
    "problem"
  ],
  "properties": {
    "problem": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "state_mass_n",
            "state_mass_d",
            "book_loss_n",
            "loss_d",
            "tail_mass_n",
            "tail_mass_d"
          ],
          "properties": {
            "state_mass_n": {
              "type": "array",
              "minItems": 2,
              "maxItems": 4,
              "items": {
                "type": "integer",
                "minimum": 1,
                "maximum": 6
              }
            },
            "state_mass_d": {
              "type": "integer",
              "minimum": 2,
              "maximum": 12
            },
            "book_loss_n": {
              "type": "array",
              "minItems": 2,
              "maxItems": 3,
              "items": {
                "type": "array",
                "minItems": 2,
                "maxItems": 4,
                "items": {
                  "type": "integer",
                  "minimum": -100,
                  "maximum": 100
                }
              }
            },
            "loss_d": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "tail_mass_n": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12
            },
            "tail_mass_d": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "additionalProperties": false
}

Open original schema

Published input example

{
  "problem": {
    "state_mass_n": [
      1,
      1,
      2
    ],
    "state_mass_d": 4,
    "book_loss_n": [
      [
        1,
        5,
        8
      ],
      [
        1,
        1,
        2
      ]
    ],
    "loss_d": 1,
    "tail_mass_n": 1,
    "tail_mass_d": 2
  }
}

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 โ†’