Skip to content
HALOWERK

Rechenwerk

effective rate

Implements the equation of the Annex to § 16 PAngV (Federal Law Gazette I 2021, 4928): the sum of present values of drawdowns equals the sum of present values of repayments, interest and costs, discounted with (1 + X)^-t. Times are in years: standard months = 1/12 year, remaining days counted back from each payment to the payout and divided by 365 or 366 (the year counted back from the last day), as in Annex no. 1 c. Upfront costs reduce the payout at t = 0. X is found by Newton iteration.

POST https://rechen.halowerk.com/v1/effective-rate

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
net_loan_amountnumberYesNet loan amount paid out at t = 0 in EUR.
upfront_costsnumberNoCosts the borrower pays at payout or that are retained from it (part of total costs, § 16(3) PAngV).
installmentsobjectNoRegular payment plan in standard months.
final_paymentobjectNoOptional extra final payment (with installments).
paymentsarrayNoFree payment list (alternative to installments).
payout_datestringNoPayout date for dated_payments.
dated_paymentsarrayNoPayments with calendar dates (alternative); months are counted back from each date, then days.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "net_loan_amount"
  ],
  "properties": {
    "net_loan_amount": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000000,
      "description": "Net loan amount paid out at t = 0 in EUR."
    },
    "upfront_costs": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000000,
      "default": 0,
      "description": "Costs the borrower pays at payout or that are retained from it (part of total costs, § 16(3) PAngV)."
    },
    "installments": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "amount",
        "count"
      ],
      "properties": {
        "amount": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 10000000000,
          "description": "Regular payment in EUR."
        },
        "count": {
          "type": "integer",
          "minimum": 1,
          "maximum": 600,
          "description": "Number of regular payments."
        },
        "interval_months": {
          "type": "integer",
          "minimum": 1,
          "maximum": 12,
          "default": 1,
          "description": "Standard months between payments."
        },
        "first_after_months": {
          "type": "integer",
          "minimum": 0,
          "maximum": 120,
          "default": 1,
          "description": "Standard months from payout to the first payment."
        }
      },
      "description": "Regular payment plan in standard months."
    },
    "final_payment": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "amount",
        "after_months"
      ],
      "properties": {
        "amount": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 10000000000,
          "description": "Balloon or final payment in EUR."
        },
        "after_months": {
          "type": "integer",
          "minimum": 1,
          "maximum": 1200,
          "description": "Standard months after payout."
        }
      },
      "description": "Optional extra final payment (with installments)."
    },
    "payments": {
      "type": "array",
      "maxItems": 1200,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "amount"
        ],
        "properties": {
          "after_months": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1200,
            "default": 0,
            "description": "Whole standard months after payout."
          },
          "after_days": {
            "type": "integer",
            "minimum": 0,
            "maximum": 366,
            "default": 0,
            "description": "Additional days (divided by 365)."
          },
          "amount": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 10000000000,
            "description": "Payment in EUR."
          }
        }
      },
      "description": "Free payment list (alternative to installments)."
    },
    "payout_date": {
      "type": "string",
      "format": "date",
      "description": "Payout date for dated_payments."
    },
    "dated_payments": {
      "type": "array",
      "maxItems": 1200,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "date",
          "amount"
        ],
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Payment date."
          },
          "amount": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 10000000000,
            "description": "Payment in EUR."
          }
        }
      },
      "description": "Payments with calendar dates (alternative); months are counted back from each date, then days."
    }
  }
}

Open original schema

Published input example

{
  "net_loan_amount": 10000,
  "installments": {
    "amount": 860.66,
    "count": 12
  }
}

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 →