ForHosting KIT · Finances et argent

Calculateur de ROI

Indiquez ce que vous avez investi et ce qui est revenu : 1000 investis et 1200 récupérés font un bénéfice net de 200,00 et un ROI de 20,00 %. Les montants sont traités en centimes exacts, sans dérive d'arrondi. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Montant investi: 1000
Montant récupéré: 1200

Vous obtenez

Montant investi: 1000.00
Montant récupéré: 1200.00
Bénéfice net: 200.00
Retour sur investissement (%): 20.00

Saisissez le capital investi et le montant total récupéré pour obtenir le bénéfice net et le pourcentage de ROI, calculés en centimes entiers exacts avec un arrondi half-up à l'écart de zéro à deux décimales.

Ce que mesure le ROI

Le retour sur investissement compare ce qu'un placement a rapporté à ce qu'il a coûté. Retranchez le capital investi du montant total récupéré pour obtenir le bénéfice net, divisez ce bénéfice par le capital investi et multipliez par 100. Investir 1000 et récupérer 1200 donne un bénéfice net de 200,00 et un ROI de 20,00 %. Un chiffre positif signifie que l'argent a fructifié, un chiffre négatif qu'une partie a été perdue, et ne rien récupérer correspond à −100 %. Afficher le pourcentage à côté du bénéfice net permet de trier une opération d'un coup d'œil.

Des centimes exacts, un arrondi prévisible

Les montants sont convertis en centimes entiers avant tout calcul, si bien que l'argent n'accumule jamais les petites erreurs des fractions binaires : 1000 et 1200 deviennent 100000 et 120000 centimes. Le pourcentage est ensuite arrondi à deux décimales, la moitié vers le haut et en s'éloignant de zéro : une perte qui tombe pile sur une moitié s'arrondit en s'éloignant de zéro et non vers lui. Il devient ainsi facile de vérifier, ligne par ligne, une colonne de ROI à deux décimales dans votre propre tableur.

Cas d’usage

Sélection d'opérations

Affichez le pourcentage de ROI et le bénéfice net à côté d'une simple mise de capital.

Validation de tableur

Vérifiez une colonne de ROI à deux décimales, arrondie half-up, par rapport à votre propre feuille, côté serveur.

Questions fréquentes

Les nombres à virgule flottante sont-ils autorisés ?

Non. Utilisez un entier non négatif ou une chaîne monétaire comportant au plus deux décimales.

Comment le pourcentage est-il arrondi ?

Half-up à l'écart de zéro à deux décimales, calculé entièrement en centimes entiers.

Que se passe-t-il si j'ai récupéré moins que ma mise ?

Le bénéfice net et le ROI deviennent tous deux négatifs. Si rien ne revient, soit un retour de zéro, le ROI vaut −100 %, ce qui signifie que tout l'investissement est perdu.

Le capital investi peut-il être nul ?

Non. L'investissement doit être supérieur à zéro, car le ROI est divisé par lui. Le montant récupéré, en revanche, peut être nul pour représenter une perte totale.

Combien de décimales puis-je saisir ?

Jusqu'à deux, comme dans 1200,5 ou 1200,50. Un signe plus en tête, des zéros de remplissage comme dans 01000, la notation scientifique ou plusieurs séparateurs décimaux sont refusés comme format incorrect.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

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

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre 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)

Exemple de requête

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

Exemple de réponse

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

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Formule et analyse des montants

dev.roi calcule le retour sur investissement comme (return_amount − investment) ÷ investment × 100, aux côtés du net_profit qui le sous-tend. Pour éviter la dérive du binaire flottant sur les montants, les deux entrées sont converties en centimes entiers avec BigInt avant tout calcul : l'exemple 1000 et 1200 devient 100000 et 120000 centimes, donnant un net_profit de 200,00 et un roi_percent de 20,00. Chaque champ accepte soit un entier sûr non négatif, soit une chaîne décimale canonique comportant au plus deux chiffres après la virgule — « 1200 », « 1200.5 » et « 1200.50 » sont tous valides, mais un signe plus en tête, des zéros de remplissage comme « 01000 », la notation scientifique, plus d'un séparateur décimal ou un littéral flottant JavaScript sont tous rejetés comme un mauvais format. investment doit se convertir en plus de zéro centime pour que la division soit définie ; return_amount peut valoir zéro, ce qui représente une perte totale et donne un pourcentage de −100,00.

Centimes entiers et half-up à l'écart de zéro

Les deux centièmes qui restent deviennent les deux décimales de la chaîne de pourcentage. roi_percent n'est jamais calculé en virgule flottante. Travaillant entièrement en BigInt, le moteur forme profit_cents × 10000, puis divise par investment_cents avec une étape explicite half-up, à l'écart de zéro — il ajoute la moitié du diviseur avant la division entière et reflète le signe pour les pertes, de sorte qu'une valeur exactement à −0,5 s'arrondit à −1 plutôt que vers zéro. Lorsque return_amount est inférieur à investment, net_profit et roi_percent portent tous deux un moins en tête : investissez 1000, récupérez 800, et vous voyez net_profit −200,00 avec roi_percent −20,00.

Sorties, erreurs et où l'exécuter

La conception reste délibérément étroite — la version un n'annualise pas, ne pondère pas un portefeuille et ne convertit pas de devises — de sorte que la surface signée est courte et auditable. Les tâches en échec ne sont jamais débitées du solde prépayé. Chaque réponse réussie renvoie quatre chaînes à deux décimales : investment et return_amount normalisés sous forme canonique, net_profit avec son signe, et roi_percent. Les chemins d'erreur utilisent des messages stables et repérables, chacun levé comme un invalid_input typé : un investment ou un return_amount manquant, un investment nul, une valeur négative signalée comme negativo devant le nom du champ, et un montant malformé rapporté comme un format invalide.

Cas d'intégration

Tests golden de CI

Figez des chaînes exactes de net_profit et de roi_percent qui ne dérivent jamais d'une plateforme à l'autre.

Questions techniques

investment peut-il valoir zéro ?

Non. Il doit se convertir en plus de zéro centime, faute de quoi vous obtenez une erreur typée invalid_input.

Le ROI peut-il être négatif ?

Oui, lorsque return_amount est inférieur à investment ; net_profit et le pourcentage portent tous deux un moins.

Est-ce gratuit dans le navigateur ?

Oui. L'API coûte $0.002 par appel, facturé uniquement sur les tâches réussies.

Consulter la documentation complète du KIT →

Lancer gratuitement