TRIR-Rechner

Eingabevertrag, leere Listen und die Form der Antwort

Acht bedeutet acht Prozent für jene Periode, nicht ein Dezimal 0.08, es sei denn, Sie meinen wirklich acht Hundertstel Prozent. Nutzen Sie eins für Jahresreihen, vier für vierteljährliche, zwölf für monatliche, zweiundfünfzig für wöchentliche oder dreihundertfünfundsechzig für tägliche. Eine Null, ein negativer Wert oder ein Bruch wie 2.5 wird zurückgewiesen statt still gerundet. Fehlgeschlagene Prüfung wird nicht berechnet. Halten Sie Listen bei höchstens zehntausend Perioden. Senden Sie per POST einen JSON-Körper, dessen Pflichtfeld returns ist, ein nicht leeres Array endlicher Prozentsätze. Die Aliase periodic_returns, rates und r zeigen auf dieselbe Liste, damit eine Tabellenspalte einen vertrauten Namen behalten kann. Fehlt returns, ist es leer oder keine Liste endlicher Zahlen, schlägt die Aufgabe mit invalid_input fehl, benennt returns und wird nicht berechnet; die vertragliche Meldung zur leeren Liste stellt fest, dass returns eine nicht leere Liste periodischer Renditen sein muss. Das optionale periods_per_year ist eine positive ganze Zahl von eins bis dreihundertfünfundsechzig und beträgt eins, wenn es weggelassen wird; die Aliase frequency, ppy und compounds_per_year werden akzeptiert. Jeder Skalar darf als JSON-Zahl oder als numerische Zeichenkette ankommen; die Liste selbst darf ein JSON-Array oder eine kommagetrennte Zeichenkette sein. Bei Erfolg gibt der Körper returns als Echo zurück, meldet n und periods_per_year, gibt years als n geteilt durch p und liefert growth_factor zusammen mit total_return als Prozent, total_return_decimal als Bruch, annualized_return als Prozent und annualized_return_decimal als Bruch, plus eine formula-Zeichenkette, die die Produktidentität wiederholt.

Wo ein TRIR-Rechner seinen Platz verdient

Portfolioteams nutzen einen Rechner für die gesamtintegrierte Rendite, wenn sie bereits eine Kette von Teilperiodenergebnissen haben —monatliche Fondsblätter, vierteljährliche Mandatsberichte oder jährliche beitragsbereinigte zeitgewichtete Renditen— und die Frage das zusammengesetzte annualisierte Äquivalent ist, nicht ein Anfang-Ende-CAGR, der den Pfad ignorierte. Lernende und CFA-Kandidaten brauchen ein deterministisches Orakel, das eine Hausaufgabenserie geometrisch verknüpft und eine leere Liste zurückweist, statt still NaN zu zeigen, das ein fehlerhaftes Formular als Erfolg werten könnte. Produktteams verdrahten denselben Vertrag in Onboarding-Demos, sodass jemand, der zwölf monatliche Prozentsätze mit periods_per_year gleich zwölf einfügt, denselben annualized_return sieht, den die API später in Produktionstests zurückgibt. Weil die Umsetzung reines Parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Grundpreis $0.002 ohne Modell-Token und ohne ausgehendes Netz. Halten Sie Anfragen klein, nageln Sie gerundete annualized_return-Werte in Tests fest, und Sie erhalten reproduzierbare TRIR-Zahlen für Arbeitsblätter, LMS-Erweiterungen und Edge-Worker, ohne einen eigenen Tabellendienst aufzustellen.