Excel APIs für Immobilien: Ein Baufinanzierungsrechner als API

Ein Baufinanzierungsrechner als API, aus einer Excel-Arbeitsmappe

Eine Baufinanzierung sieht nach einer Formel aus und ist ein kleines Modell: Der Zins hängt von den Konditionen der Bank ab, die Konditionen hängen davon ab, wie viel vom Kaufpreis finanziert wird, und der Kunde will die Restschuld Jahr für Jahr sehen. Banken, Vermittler und Portale führen solche Modelle in Excel, weil die Menschen, die für die Konditionen verantwortlich sind, sie dort pflegen können.

Dieser Beitrag nimmt eine solche Arbeitsmappe und zeigt, wie sie als API aussieht. Die Arbeitsmappe ist eine Demo: Die Bank und ihre Konditionen sind erfunden. Der Service ist echt. Er ist auf SpreadAPI veröffentlicht, die Aufrufe unten liefen am 13. November 2026, und die Antworten sind die, die er zurückgegeben hat. Ausprobieren kannst du ihn auf der Seite Baufinanzierungsrechner als API.

Die Arbeitsmappe

Die Excel-Datei hat drei Blätter.

Finanzierung ist das Rechenblatt, mit fünf Eingabezellen und sieben Ergebniszellen:

  • Der Darlehensbetrag ist der Kaufpreis minus das Eigenkapital.
  • Der Beleihungsauslauf ist der Darlehensbetrag geteilt durch den Kaufpreis.
  • Der Sollzins wird in den Konditionen nachgeschlagen, mit INDEX, XVERGLEICH für die Beleihungsstufe und VERGLEICH für die Zinsbindung.
  • Die Monatsrate ist der Darlehensbetrag mal Sollzins plus anfängliche Tilgung, geteilt durch 12.
  • Die Laufzeit bis zur Volltilgung kommt aus ZZR.

Tilgungsplan hat eine Zeile pro Jahr der Zinsbindung. Er ist eine einzige überlaufende Formel auf Basis von SEQUENZ und LET, sodass der Plan mit der Zinsbindung von 5 auf 10 oder 15 Zeilen wächst.

Konditionen enthält die Zinssätze der Bank: vier Beleihungsstufen (bis 60 %, 80 %, 90 % und 100 %) und drei Zinsbindungen (5, 10 und 15 Jahre).

Nichts davon ist ein Makro. Das ist wichtig, denn VBA-Makros laufen in einem Service nicht; Formeln schon.

Der Service

Die Arbeitsmappe zu veröffentlichen heißt festzulegen, welche Zellen ein Aufrufer füllen darf und welche zurückkommen. Die Schritte stehen in Dein erster Service.

Die Eingaben, mit den Grenzen, die im Service gesetzt sind:

  • purchase_price (Kaufpreis): 100.000 bis 2.000.000
  • down_payment (Eigenkapital): 0 bis 1.000.000
  • fixed_period (Zinsbindung): 5, 10 oder 15 Jahre
  • initial_repayment (anfängliche Tilgung): 1 % bis 10 %, als Dezimalzahl gesendet
  • extra_repayment (Sondertilgung): 0 bis 20.000 pro Jahr

Die Ausgaben:

  • loan_amount, loan_to_value, interest_rate, monthly_payment
  • balance: die Restschuld am Ende der Zinsbindung
  • interest: die Zinsen, die in der Zinsbindung gezahlt werden
  • years_to_repay: die Laufzeit bis zur Volltilgung
  • repayment_plan: der Tilgungsplan vom zweiten Blatt, als Zellbereich

Das Blatt mit den Konditionen ist weder Eingabe noch Ausgabe. Ein Aufrufer sieht es nie.

Ein Aufruf

curl -X POST \
  "https://spreadapi.io/api/v1/services/{serviceId}/execute" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"purchase_price": 420000, "down_payment": 90000,
       "fixed_period": 10, "initial_repayment": 0.02,
       "extra_repayment": 0}}'

Die Ausgaben der Antwort, gekürzt auf Name, Wert und Zahlenformat:

loan_amount      330000     #,##0.00 €
loan_to_value    0.7857     0.0%
interest_rate    0.0371     0.00%
monthly_payment  1570.25    #,##0.00 €
balance          250238.93  #,##0.00 €
interest         108668.93  #,##0.00 €
years_to_repay   28.3       0.0
repayment_plan   (ein Bereich, siehe unten)

So liest du das: 330.000 € werden finanziert, das sind 78,6 % des Kaufpreises. Das fällt in die Stufe "bis 80 %", und für 10 Jahre Zinsbindung liefern die Konditionen 3,71 %. Die Rate beträgt 1.570,25 € im Monat. Nach 10 Jahren sind noch 250.238,93 € offen, und 108.668,93 € Zinsen sind gezahlt.

Werte kommen roh zurück. 0.0371 ist der Wert der Zelle, und formatString sagt deinem Frontend, dass es ihn als 3,71 % anzeigen soll. Prozentwerte gehen genauso hinein: 0.02 für 2 %.

Der Tilgungsplan ist ein Bereich

Eine Ausgabe kann ein Zellbereich sein. Er kommt als Liste von Zeilen zurück, jede Zeile eine Liste von Zellwerten. Die ersten Zeilen von repayment_plan aus dem Aufruf oben:

Jahr  Rate   Zinsen    Tilgung  Sondertilgung  Restschuld
1     18843  12129.61  6713.39  0              323286.61
2     18843  11876.26  6966.74  0              316319.87
3     18843  11613.36  7229.64  0              309090.23
...
10    18843  9473.23   9369.77  0              250238.93

Zinsen und Tilgung haben wir für diese Darstellung auf zwei Nachkommastellen gerundet. Die API hat sie so zurückgegeben, wie die Zellen sie halten, zum Beispiel 12129.609999999986. Runde für die Anzeige in deinem Frontend oder mit RUNDEN in der Arbeitsmappe.

Zwei Dinge solltest du über Bereichs-Ausgaben wissen:

  • Der Bereich wird beim Einrichten des Service festgelegt. Hier hat er Platz für 15 Jahre. Bei einer Zinsbindung von 10 Jahren enthält die Antwort also die Kopfzeile, 10 Zeilen mit Zahlen und 5 Zeilen mit leeren Zellen (null). Überspringe leere Zeilen, wenn du den Plan darstellst.
  • Der Plan ist Teil jeder Antwort. Wenn ein Client nur die Monatsrate braucht, hält ein zweiter Service ohne den Plan seine Antworten klein.

Vier Szenarien in einer Anfrage

Ein Kunde stellt selten nur eine Frage. "Was, wenn ich den Zins 15 Jahre festschreibe? Was, wenn ich mehr tilge?" Die Discovery-Adresse eines Service nimmt 2 bis 20 Szenarien in einer Anfrage. Das ist das Skript, das wir ausgeführt haben, mit Node.js 22 und ohne Pakete:

// Vier Finanzierungsvarianten in einer Anfrage vergleichen
const DISCOVERY = 'https://spreadapi.io/d/{serviceId}';

const base = {
  purchase_price: 420000,
  down_payment: 90000,
  fixed_period: 10,
  initial_repayment: 0.02,
  extra_repayment: 0
};

const response = await fetch(DISCOVERY, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    action: 'batch',
    scenarios: [
      { label: '5 Jahre Zinsbindung', inputs: { ...base, fixed_period: 5 } },
      { label: '10 Jahre Zinsbindung', inputs: base },
      { label: '15 Jahre Zinsbindung', inputs: { ...base, fixed_period: 15 } },
      { label: '10 Jahre, 3 % Tilgung, 5.000 Sondertilgung',
        inputs: { ...base, initial_repayment: 0.03, extra_repayment: 5000 } }
    ]
  })
});

const data = await response.json();
const pick = ['interest_rate', 'monthly_payment', 'balance', 'years_to_repay'];

for (const scenario of data.scenarios) {
  const values = Object.fromEntries(
    scenario.outputs.map((o) => [o.name, o.value])
  );
  console.log(scenario.label, pick.map((name) => `${name}=${values[name]}`).join(' '));
}

Seine Ausgabe:

5 Jahre Zinsbindung interest_rate=0.0348 monthly_payment=1507 balance=294011.81 years_to_repay=29
10 Jahre Zinsbindung interest_rate=0.0371 monthly_payment=1570.25 balance=250238.93 years_to_repay=28.3
15 Jahre Zinsbindung interest_rate=0.0393 monthly_payment=1630.75 balance=195422.01 years_to_repay=27.7
10 Jahre, 3 % Tilgung, 5.000 Sondertilgung interest_rate=0.0371 monthly_payment=1845.25 balance=150953.94 years_to_repay=21.7

Die ersten drei Zeilen zeigen die Konditionen bei der Arbeit: Eine längere Zinsbindung kostet einen höheren Zins, 3,48 %, 3,71 % und 3,93 %. Die letzte Zeile ist die Variante mit 3 % anfänglicher Tilgung und 5.000 € Sondertilgung pro Jahr: Die Rate steigt auf 1.845,25 €, und die Restschuld nach 10 Jahren sinkt von 250.238,93 € auf 150.953,94 €.

Jedes Szenario zählt als ein Aufruf des Service.

Was ein Aufrufer nicht senden kann

Der Service lehnt einen Wert außerhalb seiner Grenzen ab, bevor gerechnet wird, mit HTTP 400 und einer Meldung, die die Eingabe nennt. Eine Zinsbindung von 7 Jahren steht nicht in der Liste der erlaubten Werte; ein Kaufpreis von 50.000 liegt unter dem Minimum. Diese Fälle haben wir nicht gegen den Baufinanzierungs-Service ausgeführt. Die Antwort auf einen abgelehnten Wert zeigt ein echtes Beispiel in KI-Agenten entwickeln, die deine Excel-Modelle nutzen.

Diese Grenzen sind der Ort für die Regeln des Geschäfts: welche Darlehensgrößen du finanzierst, welche Zinsbindungen du anbietest. Sie werden pro Eingabe im Service gesetzt; eine Dropdown-Liste in der Arbeitsmappe wird beim Import zur Liste der erlaubten Werte. Siehe Eingabeprüfung.

Wo derselbe Service verwendet wird

  • Auf einer Website: Dein Frontend ruft die API auf und stellt das Ergebnis dar. Oder du nutzt den Web-Rechner, den SpreadAPI aus dem Service macht, ohne Frontend-Code. Siehe Excel Web-Rechner.
  • In einem KI-Assistenten: Jeder veröffentlichte Service hat eine MCP-Adresse. Ein Assistent wie Claude oder ChatGPT sendet die Eingaben und gibt die Ausgaben wieder, statt eine Rate zu schätzen. Siehe Excel MCP Server.
  • In einem Workflow: als Schritt in n8n, Zapier oder Power Automate, zum Beispiel um die Rate in ein Angebotsdokument zu schreiben.

Alle bekommen dieselben Zahlen, weil alle dieselbe Arbeitsmappe aufrufen.

Wenn sich die Konditionen ändern

Zinssätze ändern sich oft. Wer die Arbeitsmappe pflegt, ändert das Blatt mit den Konditionen in Excel. Dann wird die neue Arbeitsmappe in den Service importiert und erneut veröffentlicht. Eingaben, Ausgaben und Tokens bleiben erhalten, und Aufrufer bekommen die neuen Zinssätze ab dem nächsten Aufruf. Bis dahin bekommen sie die veröffentlichte Version.

SpreadAPI führt keine Versionshistorie eines Service. Lege die datierten Arbeitsmappen in deiner eigenen Ablage ab, damit du später zeigen kannst, welche Konditionen wann galten.

Was dieses Beispiel nicht ist

  • Keine echte Bank. Die Konditionen sind erfunden. Die Zahlen zeigen, wie der Service antwortet, nicht, was ein Darlehen kostet.
  • Keine Beratung. Ein Service gibt zurück, was die Formeln berechnen. Ob ein Angebot verbindlich ist und welche Pflichtangaben es braucht, liegt in deiner Verantwortung.
  • Nicht jede Baufinanzierung. Diese Arbeitsmappe bildet ein Annuitätendarlehen mit Zinsbindung, anfänglicher Tilgung und jährlicher Sondertilgung ab. Andere Produkte brauchen andere Formeln, und die schreibst du, in Excel.
  • Keine Zielwertsuche. "Wie viel kann ich mir für 1.500 € im Monat leihen?" dreht die Berechnung um. Ein Service sucht nicht nach einer Eingabe; wie du solche Fragen beantwortest, steht in Excel-Zielwertsuche über eine API.

Zum Weiterlesen