ForHosting KIT · Outils pour développeurs

Rendement pondéré dans le temps

Le rendement pondéré dans le temps mesure la performance d'une stratégie d'investissement sans que le montant ou la date des apports et retraits externes faussent le résultat.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Saisissez les valeurs du portefeuille pour des sous-périodes consécutives, placez chaque flux de trésorerie au début ou à la fin de sa période, puis le calculateur détermine chaque rendement avant de les chaîner en une valeur cumulée. Vous pouvez ainsi comparer des gestionnaires, modèles ou stratégies entre des comptes alimentés de montants différents à des dates distinctes.

Découpez la période à chaque flux de trésorerie externe

Le calcul commence par la division de toute la période d'observation en sous-périodes. Une limite doit être créée chaque fois que des fonds entrent dans le portefeuille ou en sortent pour une raison indépendante de la performance des placements. Les apports, dépôts, retraits et distributions sortant du compte sont des flux de trésorerie externes. Les intérêts, dividendes conservés dans le portefeuille, frais et gains ou pertes de marché font normalement partie de la performance et ne doivent pas être saisis comme flux. Pour chaque sous-période, indiquez la valeur de marché au début et à la fin. Saisissez ensuite le flux externe sous forme de nombre positif pour un apport ou négatif pour un retrait. Choisissez début lorsque la somme pouvait être investie pendant toute la sous-période. Choisissez fin lorsqu'elle est arrivée après la performance de la période ou que le retrait a été réalisé ensuite. La précision des valorisations aux limites est essentielle : si un flux intervient au milieu d'une longue période, créez une valorisation à cet instant. Les lignes doivent suivre l'ordre chronologique, car le calculateur chaîne les rendements dans cet ordre.

Comprenez les formules et le chaînage

Pour un flux placé à la fin, le calculateur soustrait ce flux de la valeur finale, puis divise la valeur finale corrigée par la valeur initiale. Pour un flux placé au début, il l'ajoute à la valeur initiale et divise la valeur finale par ce capital investi. La soustraction de un à l'un ou l'autre rapport donne le rendement de la sous-période. Chaque rendement est ensuite transformé en facteur de croissance, tous les facteurs sont multipliés, puis un est soustrait au produit. Un gain suivi d'une perte est donc composé et non moyenné : des pourcentages positif et négatif identiques ne s'annulent pas, car le second s'applique à une autre base de capital. La réponse fournit les formes décimale et en pourcentage de chaque rendement, le facteur de croissance final et le rendement cumulé pondéré dans le temps. L'arrondi ne concerne que les valeurs affichées, après l'intégration de chaque calcul en pleine précision dans la chaîne. Le résultat reste ainsi stable sans la dérive que provoquerait le chaînage de pourcentages intermédiaires arrondis.

Interprétez le résultat et ses limites

Utilisez le pourcentage final pour évaluer le processus d'investissement indépendamment des décisions de financement du titulaire du compte. Cette mesure convient particulièrement à la comparaison de gestionnaires, d'indices de référence, de portefeuilles modèles ou d'une même stratégie entre des comptes aux calendriers d'apports différents. Un résultat positif signifie qu'une unité de capital exposée pendant toutes les sous-périodes a progressé ; un résultat négatif indique une baisse. Le facteur de croissance exprime le même résultat de façon multiplicative : supérieur à un, il traduit une croissance ; inférieur à un, une perte. Le rendement pondéré dans le temps ne représente pas le rendement personnel de l'investisseur lorsque des dépôts ou retraits importants ont eu lieu. Le rendement pondéré par les capitaux ou le taux de rendement interne répond mieux à cette question en pondérant les flux selon leur date et leur montant. Ce calculateur n'annualise pas non plus le résultat, ne déduit pas les valorisations manquantes, n'estime pas les dates intrapériodes et ne compare aucun indice. Vérifiez les rendements détaillés afin de repérer une ligne invraisemblable avant toute utilisation dans un rapport ou une analyse.

Évaluer un gestionnaire de portefeuille

Neutralisez les dépôts et retraits décidés par le client afin que le rendement reflète les choix d'investissement plutôt que leur calendrier.

Comparer des portefeuilles modèles

Chaînez des rendements cohérents pour des stratégies suivies par des comptes aux soldes et calendriers d'apports différents.

Préparer des rapports de performance

Produisez un rendement cumulé vérifiable avec les rendements partiels utilisés dans le chaînage.

Quel est le coût du calculateur ?

Chaque requête API coûte $0.002. Le même calcul déterministe peut également être exécuté dans le navigateur.

Les apports doivent-ils être positifs ou négatifs ?

Saisissez les apports comme des flux positifs et les retraits comme des flux négatifs.

Quand faut-il choisir début plutôt que fin ?

Choisissez début si le flux a été investi pendant toute la sous-période. Choisissez fin s'il est intervenu après la performance de cette sous-période.

Est-ce identique au taux de rendement interne ?

Non. Le rendement pondéré dans le temps neutralise le montant et la date des flux externes, tandis que le taux de rendement interne mesure l'expérience de l'investisseur pondérée par les capitaux.

Le résultat annualise-t-il la performance ?

Non. Il s'agit du rendement cumulé des sous-périodes saisies. L'annualisation nécessite la durée écoulée, absente de cette entrée.

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.

POSThttps://api.kit.forhosting.com/finance/time-weighted-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é.

curl -X POST https://api.kit.forhosting.com/finance/time-weighted-return \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"periods":[{"beginning_value":10000,"ending_value":10800,"cash_flow":500,"cash_flow_timing":"end"},{"beginning_value":11300,"ending_value":11752,"cash_flow":0,"cash_flow_timing":"end"}]}'
{
  "periods": [
    {
      "beginning_value": 10000,
      "ending_value": 10800,
      "cash_flow": 500,
      "cash_flow_timing": "end"
    },
    {
      "beginning_value": 11300,
      "ending_value": 11752,
      "cash_flow": 0,
      "cash_flow_timing": "end"
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.time_weighted_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.

par requête$0.002

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

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →