Calculateur TRIR

Contrat d'entrée, listes vides et forme de la réponse

Huit signifie huit pour cent pour cette période, non un décimal 0.08 sauf si vous visez vraiment huit centièmes de pour cent. Utilisez un pour des séries annuelles, quatre pour trimestrielles, douze pour mensuelles, cinquante-deux pour hebdomadaires ou trois cent soixante-cinq pour quotidiennes. Un zéro, une valeur négative ou une fraction telle que 2.5 est rejeté plutôt qu'arrondi en silence. Une validation échouée ne consomme pas de solde. Gardez les listes à dix mille périodes ou moins. Envoyez par POST un corps JSON dont le champ obligatoire est returns, un tableau non vide de pourcentages finis. Les alias periodic_returns, rates et r pointent vers la même liste afin qu'une colonne de tableur conserve un nom familier. Si returns manque, est vide ou n'est pas une liste de nombres finis, la tâche échoue avec invalid_input en nommant returns et n'est pas facturée ; le message contractuel de liste vide affirme que returns doit être une liste non vide de rendements périodiques. L'optionnel periods_per_year est un entier positif de un à trois cent soixante-cinq et vaut un lorsqu'il est omis ; les alias frequency, ppy et compounds_per_year sont acceptés. Chaque scalaire peut arriver comme nombre JSON ou comme chaîne numérique ; la liste elle-même peut être un tableau JSON ou une chaîne séparée par des virgules. En cas de succès, le corps répète returns, signale n et periods_per_year, donne years comme n divisé par p et renvoie growth_factor ainsi que total_return en pourcentage, total_return_decimal en fraction, annualized_return en pourcentage et annualized_return_decimal en fraction, plus une chaîne formula qui reformule l'identité du produit.

Où un calculateur TRIR justifie sa place

Les équipes de portefeuilles utilisent un calculateur de taux intégré total de rendement lorsqu'elles disposent déjà d'une chaîne de résultats de sous-période —fiches mensuelles de fonds, rapports trimestriels de mandat ou rendements annuels pondérés par le temps et ajustés des apports— et que la question est l'équivalent annualisé composé, non un CAGR début-fin qui ignorerait la trajectoire. Les étudiants et les candidats CFA ont besoin d'un oracle déterministe qui lie géométriquement une série de devoirs et refuse une liste vide au lieu d'afficher silencieusement NaN, chiffre qu'un formulaire défectueux pourrait traiter comme un succès. Cette page n'est pas un outil CAGR de valeur initiale et de valeur finale, ni une EAR à partir d'une seule cotation nominale et d'un décompte de capitalisation, ni un IRR pondéré par l'argent qui dépend du calendrier des flux : ces requêtes sont d'autres intentions et ont déjà leurs pages. Les équipes produit branchent le même contrat sur des démonstrations d'accueil afin que quiconque colle douze pourcentages mensuels avec periods_per_year égal à douze voie le même annualized_return que l'API renverra ensuite dans les tests de production. Comme l'implémentation est parse pur de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle et sans réseau sortant. Gardez les requêtes petites, figez annualized_return arrondi dans les tests, et vous obtenez des chiffres TRIR reproductibles pour tableurs, greffons LMS et workers de bord sans dresser un service de feuilles à vous.