ForHosting KIT · Finances et argent

Taux de rendement annualisé

Un placement passé de 10 000 à 16 105,10 en cinq ans a gagné 61,05 % au total, soit exactement 10 % par an une fois la capitalisation prise en compte. Comparez des placements de toute durée sur une même base annuelle. 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

Valeur initiale: 10 000
Valeur finale: 16 105,1
Années: 5

Vous obtenez

Rendement annualisé (%): 10
Rendement annualisé: 0,1
Rendement total (%): 61,051

Vous indiquez la valeur initiale, la valeur finale et la durée de détention en années, et vous obtenez le pourcentage annuel constant qui aurait conduit le premier chiffre au second — le rendement annualisé géométrique — ainsi que le rendement total sur toute la période. Elle fonctionne de manière déterministe, sans données de marché ni hypothèses sur les flux de trésorerie intermédiaires, de sorte que les mêmes entrées produisent toujours la même réponse, que vous l'appeliez une fois dans un navigateur ou un million de fois depuis un pipeline de rapports.

Ce que mesure réellement le taux de rendement annualisé

Un investissement qui passe de 10,000 à 16,105.10 en cinq ans a gagné 61.05 pour cent au total, mais ce chiffre est inutilisable pour le comparer à un autre détenu dix-huit mois. Le taux de rendement annualisé convertit toute durée de détention en valeur annuelle en recherchant le taux de croissance annuel constant, composé, qui reproduit la variation observée. Mathématiquement, c'est r = (finale / initiale)^(1 / années) − 1, exprimé ici en pourcentage.

Pour l'exemple ci-dessus, la réponse est exactement 10 pour cent par an. Comme la formule prend la racine n-ième du multiple de croissance, elle tient correctement compte de la capitalisation : deux années consécutives à 10 pour cent produisent 21 pour cent au total, et non 20. Le résultat est le rendement annualisé géométrique, la mesure correcte lorsque les gains sont réinvestis et que vous voulez un chiffre annuel comparable.

Entrées, validation et lecture du résultat

Les trois entrées sont obligatoires. La réponse reprend les trois entrées pour que vos enregistrements restent auto-descriptifs, puis ajoute le rendement annualisé sous forme de pourcentage et de fraction décimale, ainsi que le rendement total sur toute la période pour le contexte. Un chiffre annualisé négatif signifie que l'investissement a perdu de la valeur en base annuelle composée.

Si un champ manque ou n'est pas un nombre fini, le message d'erreur nomme le champ fautif pour qu'un formulaire ou un pipeline puisse indiquer exactement quoi corriger.

Quand l'utiliser — et quand ne pas l'utiliser

Il est idéal pour normaliser des investissements détenus sur des durées différentes afin de les classer équitablement, et pour renseigner un chiffre de performance annuelle dans les tableaux de bord et les rapports clients. Ne l'utilisez pas lorsque de l'argent est entré ou sorti pendant la période : les versements et les retraits faussent la formule simple à deux points, et l'outil adapté est alors un calcul de taux de rentabilité interne sur les flux de trésorerie réels.

Il lisse aussi la volatilité par construction : un actif qui a doublé, perdu la moitié puis doublé à nouveau ne montre que le trajet net entre les deux extrémités.

Cas d’usage

Comparez des investissements détenus sur des durées différentes

Ramenez une position boursière de trois ans et une opération de dix-huit mois à la même base annuelle avant de décider laquelle a le mieux performé.

Renseignez la performance annuelle dans un rapport

Envoyez les soldes initial et final dans un pipeline de rapports et attachez un chiffre annualisé cohérent à chaque compte, fonds ou portefeuille.

Vérifiez qu'un objectif a été atteint

Confirmez qu'un investissement censé rapporter 8 pour cent par an l'a réellement fait, compte tenu du montant investi et du montant récupéré.

Questions fréquentes

Combien cela coûte-t-il ?

L'exécution est également gratuite dans votre navigateur sur cette page.

Quelle formule utilise-t-il ?

C'est le rendement annualisé géométrique, qui tient compte de la capitalisation.

Que se passe-t-il si la durée de détention est nulle ou négative ?

La durée de détention doit être supérieure à zéro.

La valeur finale peut-elle être nulle ?

Oui. Une valeur finale nulle représente une perte totale et produit un rendement annualisé de moins 100 pour cent.

Gère-t-il les versements ou retraits pendant la période ?

Non. Il suppose une seule position achetée et conservée entre deux valorisations. Pour des flux intermédiaires, il faut un calcul de taux de rentabilité interne.

Un résultat négatif est-il possible ?

Oui. Chaque fois que la valeur finale est inférieure à la valeur initiale, le rendement annualisé est négatif, ce qui reflète une perte annuelle composée.

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/fin/annualized-rate-of-return

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/fin/annualized-rate-of-return \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"initial_value":10000,"final_value":16105.1,"years":5}'

const res = await fetch("https://api.kit.forhosting.com/fin/annualized-rate-of-return", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "initial_value": 10000,
    "final_value": 16105.1,
    "years": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/annualized-rate-of-return",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "initial_value": 10000,
    "final_value": 16105.1,
    "years": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/annualized-rate-of-return", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"initial_value":10000,"final_value":16105.1,"years":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"initial_value":10000,"final_value":16105.1,"years":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/annualized-rate-of-return", 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

{
  "initial_value": 10000,
  "final_value": 16105.1,
  "years": 5
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.annualized_rate_of_return",
  "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

L'API de taux de rendement annualisé répond à la question à laquelle toute comparaison d'investissements finit par se réduire : combien cela a-t-il rapporté par an ?

Ce que mesure réellement le taux de rendement annualisé

Le endpoint n'a besoin que de trois nombres — valeur initiale, valeur finale et années — et la valeur des années peut être fractionnaire : une position détenue trente mois correspond simplement à 2.5 années.

Entrées, validation et lecture du résultat

La valeur initiale doit être strictement supérieure à zéro, car un multiple de croissance par rapport à zéro n'est pas défini ; la valeur finale peut être nulle, ce qui représente une perte totale et donne un rendement annualisé de moins 100 pour cent ; et la durée de détention doit être positive — une requête avec des années nulles ou négatives est rejetée avec une erreur invalid_input et n'est jamais facturée.

Quand l'utiliser — et quand ne pas l'utiliser

Utilisez ce endpoint chaque fois que vous ne connaissez que les deux extrémités d'un investissement : le prix d'achat et de vente d'un bien immobilier, le solde initial et final d'un compte sans versements intermédiaires, ou la valeur d'une position à deux dates de rapport. Le calcul coûte $0.002 par appel via l'API et s'exécute gratuitement dans votre navigateur sur cette page, avec exactement le même code des deux côtés, de sorte que le chiffre avec lequel vous testez est celui que vous payez.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Ce que mesure réellement le taux de rendement annualisé

Entrées, validation et lecture du résultat

Quand l'utiliser — et quand ne pas l'utiliser

Cas d’usage

Comparez des investissements détenus sur des durées différentes

Renseignez la performance annuelle dans un rapport

Vérifiez qu'un objectif a été atteint

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Ce que mesure réellement le taux de rendement annualisé

Entrées, validation et lecture du résultat

Quand l'utiliser — et quand ne pas l'utiliser

merci