Calculateur lumpsum plus SIP

Un plan lumpsum plus SIP met un montant initial au travail dès le premier jour, puis ajoute un versement mensuel fixe pour le reste de l'horizon. Ce calculateur lumpsum plus SIP accepte ces quatre nombres —lumpsum initial, SIP mensuel, rendement annuel en pourcentage et duration en années— et renvoie la valeur future totale comme somme du lumpsum capitalisé et de la valeur future de l'annuité SIP mensuelle. La duration doit être strictement positive ; un horizon nul ou négatif échoue avec invalid_input au lieu d'un sentier de croissance vide et silencieux.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Exemple : lumpsum 100000, SIP mensuel 5000, douze pour cent et dix années font cent vingt months à un taux mensuel d'un pour cent et une valeur future combinée de 1480232.14. Une validation échouée ne consomme pas de solde. Envoyez par POST un corps JSON avec quatre nombres finis obligatoires. lumpsum est l'investissement initial dans une seule monnaie ; les alias lump_sum, principal et initial sont acceptés afin que les tableurs gardent des noms de colonnes familiers, et la valeur doit se situer entre zéro et un billion inclus. sip est le versement mensuel récurrent dans les mêmes unités, avec les alias monthly_sip, pmt et monthly, également de zéro à un billion. L'un ou l'autre flux peut être zéro afin que vous projetiez un lumpsum pur ou un SIP pur sur le même contrat. rate est le rendement annuel attendu en pourcentage —douze signifie douze pour cent par an, non un décimal 0.12 sauf si vous visez vraiment douze centièmes de pour cent ; les alias annual_rate, expected_return et return_rate désignent le même champ. rate doit être supérieur à moins cent et au plus cent afin que un plus le taux mensuel reste positif et que la puissance reste finie. duration est l'horizon en années, un nombre fini positif strictement supérieur à zéro et au plus quatre-vingts ; les années fractionnaires telles que deux point cinq sont admises, ainsi que les alias years, t et time. Si duration est absente, nulle, négative ou n'est pas un nombre fini positif, la tâche échoue avec invalid_input en nommant duration ; c'est l'erreur contractuelle et elle n'est pas facturée. Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique. En cas de succès, le corps renvoie en écho lumpsum, sip, rate et duration, indique months comme douze fois duration et monthly_rate comme le décimal i, et renvoie lumpsum_future_value, sip_future_value, future_value, total_invested et gain arrondis half-up à deux décimales pour des goldens stables de style monétaire, plus une chaîne formula qui reformule la forme fermée.

Où une API lumpsum plus SIP rend service

Les équipes produit branchent le même contrat sur des démonstrations d'accueil afin qu'une personne qui saisit un lumpsum, un SIP mensuel, un pourcentage attendu et une duration voie le même future_value que l'API renverra ensuite dans les tests de production. Comme l'implémentation est parse pure de palier A, chaque appel réussi coûte le tarif de base publié $0.002 sans jetons de modèle et sans réseau sortant. Gardez les requêtes petites, figez future_value arrondi et les deux valeurs futures de composante dans les tests, et vous obtenez des chiffres de patrimoine reproductibles pour feuilles, greffons LMS et workers de bord sans dresser un service de tableur.