ForHosting KIT · Finanzen und Geld

ROI-Rechner

Geben Sie ein, was Sie eingesetzt haben und was zurückkam: 1000 Einsatz und 1200 Rückfluss ergeben 200,00 Nettogewinn und einen ROI von 20,00 %. Beträge werden exakt in Cent gerechnet, ohne schleichende Rundungsfehler. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Rechenbeispiel

Wenn Sie eingeben

Investitionsbetrag: 1000
Rückfluss: 1200

Erhalten Sie

Investitionsbetrag: 1000.00
Rückfluss: 1200.00
Nettogewinn: 200.00
Kapitalrendite (%): 20.00

Geben Sie das eingesetzte Kapital und den insgesamt zurückgezahlten Betrag ein, um Nettogewinn und ROI in Prozent zu erhalten, berechnet in exakten ganzzahligen Cent mit half-up-Rundung weg von der Null auf zwei Nachkommastellen.

Was der ROI misst

Die Kapitalrendite vergleicht, was eine Investition eingebracht hat, mit dem, was sie gekostet hat. Ein positiver Wert heißt, dass das Geld gewachsen ist, ein negativer, dass ein Teil verloren ging, und wer nichts zurückbekommt, landet bei −100 %. Aus 1000 Einsatz und 1200 Rückfluss werden so 200,00 Nettogewinn und 20,00 % ROI. Den Prozentwert direkt neben dem Nettogewinn zu sehen, hilft Ihnen, ein Geschäft auf einen Blick einzuordnen.

Exakte Cent, vorhersehbare Rundung

Die Beträge werden vor jeder Rechnung in ganze Cent umgewandelt, so schleppt Geld nie die kleinen Fehler binärer Brüche mit: 1000 und 1200 werden zu 100000 und 120000 Cent. Danach wird der Prozentwert auf zwei Dezimalstellen gerundet, die Hälfte aufwärts und von null weg, sodass ein Verlust, der genau auf einer Hälfte liegt, von null weg gerundet wird statt zu ihr hin. So lässt sich eine ROI-Spalte mit zwei Dezimalstellen in Ihrer eigenen Tabelle Zeile für Zeile prüfen.

Anwendungsfälle

Geschäftsprüfung

Zeigen Sie ROI in Prozent und Nettogewinn neben einem einfachen Kapitaleinsatz an.

Tabellenvalidierung

Prüfen Sie eine ROI-Spalte mit zwei Nachkommastellen und half-up serverseitig gegen Ihr eigenes Blatt.

Häufige Fragen

Sind Fließkommazahlen erlaubt?

Nein. Verwenden Sie eine nicht negative Ganzzahl oder einen Geldbetragsstring mit höchstens zwei Nachkommastellen.

Wie wird der Prozentwert gerundet?

Half-up weg von der Null auf zwei Nachkommastellen, vollständig in ganzzahligen Cent berechnet.

Was passiert, wenn weniger zurückkam, als ich eingesetzt habe?

Nettogewinn und ROI werden beide negativ. Kommt gar nichts zurück, also ein Rückfluss von null, beträgt der ROI −100 %, das heißt, die gesamte Investition ist verloren.

Darf das eingesetzte Kapital null sein?

Nein. Die Investition muss größer als null sein, weil der ROI durch sie geteilt wird. Der zurückerhaltene Betrag darf dagegen null sein, um einen Totalverlust abzubilden.

Wie viele Dezimalstellen darf ich eingeben?

Bis zu zwei, etwa 1200,5 oder 1200,50. Ein vorangestelltes Pluszeichen, aufgefüllte Nullen wie in 01000, wissenschaftliche Schreibweise oder mehr als ein Dezimaltrennzeichen werden als falsches Format abgelehnt.

Wie wird der ROI berechnet?

Ziehen Sie das eingesetzte Kapital vom zurückerhaltenen Betrag ab, teilen Sie diesen Nettogewinn durch das Kapital und multiplizieren Sie mit 100. Der Nettogewinn erscheint gleich neben dem Prozentwert, weil er die Rendite bestimmt.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/dev/roi

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/dev/roi \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"investment":"1000","return_amount":"1200"}'

const res = await fetch("https://api.kit.forhosting.com/dev/roi", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "investment": "1000",
    "return_amount": "1200"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/roi",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "investment": "1000",
    "return_amount": "1200"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/roi", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"investment":"1000","return_amount":"1200"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"investment":"1000","return_amount":"1200"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/roi", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "investment": "1000",
  "return_amount": "1200"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.roi",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Technische Hinweise

Formel und Geldbetrags-Parsing

dev.roi berechnet die Kapitalrendite als (return_amount − investment) ÷ investment × 100, zusammen mit dem net_profit, der sie treibt. Um binäre Fließkomma-Abweichungen bei Geld zu vermeiden, werden beide Eingaben vor jeder Rechnung mit BigInt in ganzzahlige Cent geparst: aus dem Beispiel 1000 und 1200 werden 100000 und 120000 Cent, was net_profit 200.00 und roi_percent 20.00 ergibt. Jedes Feld akzeptiert entweder eine nicht negative sichere Ganzzahl oder einen kanonischen Dezimalstring mit höchstens zwei Nachkommastellen — "1200", "1200.5" und "1200.50" sind alle gültig, doch ein führendes Pluszeichen, aufgefüllte Nullen wie "01000", wissenschaftliche Notation, mehr als ein Dezimalpunkt oder ein JavaScript-Float-Literal werden allesamt als ungültiges Format abgelehnt. investment muss zu mehr als null Cent parsen, damit die Division definiert ist; return_amount darf null sein, was einen Totalverlust darstellt und −100.00 Prozent ergibt.

Ganzzahlige Cent und half-up weg von der Null

Die zwei verbleibenden Hundertstel werden zu den zwei Nachkommastellen des Prozentstrings. roi_percent wird niemals in Fließkomma berechnet. Vollständig in BigInt bildet die Engine profit_cents × 10000 und teilt dann durch investment_cents mit einem expliziten half-up-Schritt weg von der Null — sie addiert die Hälfte des Divisors vor der Ganzzahldivision und spiegelt das Vorzeichen bei Verlusten, sodass ein Wert von genau −0.5 zu −1 rundet und nicht zur Null hin. Wenn return_amount unter investment liegt, tragen sowohl net_profit als auch roi_percent ein führendes Minus: legen Sie 1000 an, erhalten Sie 800 zurück, und Sie sehen net_profit −200.00 mit roi_percent −20.00.

Ausgaben, Fehler und wo Sie es ausführen

Der Entwurf bleibt bewusst schmal — Version eins annualisiert nicht, gewichtet kein Portfolio und rechnet keine Währungen um —, sodass die signierte Oberfläche kurz und prüfbar ist. Fehlgeschlagene Aufgaben werden nie vom vorausbezahlten Guthaben abgezogen. Jede erfolgreiche Antwort gibt vier Strings mit zwei Nachkommastellen zurück: investment und return_amount in kanonische Form normalisiert, net_profit mit seinem Vorzeichen und roi_percent. Die Fehlerpfade verwenden stabile, abgleichbare Meldungen, jede als typisierter invalid_input geworfen: ein fehlendes investment oder return_amount, ein investment von null, ein negativer Wert als negativo vor dem Feldnamen gekennzeichnet und fehlerhaftes Geld als ungültiges Format gemeldet.

Integrationsbeispiele

CI-golden-Tests

Schreiben Sie exakte net_profit- und roi_percent-Strings fest, die über Plattformen hinweg nie driften.

Technische Fragen

Darf investment null sein?

Nein. Es muss zu mehr als null Cent parsen, sonst erhalten Sie einen typisierten invalid_input-Fehler.

Kann der ROI negativ sein?

Ja, wenn return_amount unter investment liegt; sowohl net_profit als auch der Prozentwert tragen ein Minus.

Ist es im Browser kostenlos?

Ja. Die API kostet $0.002 pro Aufruf, nur bei erfolgreichen Aufgaben berechnet.

Vollständige KIT-Dokumentation lesen →