Calculateur de taux de coupon

Une valeur nominale nulle est rejetée avec invalid_input car elle ne peut pas servir de dénominateur.

Ce que le taux de coupon signifie et comment le coupon annuel sur le nominal devient un pour cent

Cet endpoint n'extrait pas de cotations en direct, de calendriers day-count ni de spreads de crédit. La fréquence est déjà repliée dans le coupon annuel que vous envoyez : si une obligation verse vingt-cinq deux fois par an, passez cinquante comme annual_coupon, pas l'encaisse par période. Le coupon_rate renvoyé est le pourcentage coté sur les fiches ; coupon_rate_decimal est le même rapport en fraction, de sorte qu'un coupon de cinq pour cent vaut cinq et zéro virgule zéro cinq respectivement — le décimal JSON reste 0.05.

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

La valeur nominale est le champ que le contrat produit met en avant : un nominal zéro n'est jamais remplacé en silence par cent ni par mille, et un nominal manquant n'est pas traité comme zéro. Une validation en échec ne consomme pas le solde, ce qui garde bon marché les scripts exploratoires lorsque vous envoyez volontairement un nominal zéro pour confirmer le chemin d'erreur. Envoyez par POST un corps JSON avec deux nombres finis obligatoires. annual_coupon (alias annual_coupon_payment, coupon_payment, coupon et annual_payment) est l'encaisse totale de coupon que l'obligation verse en un an, en unités monétaires. Il doit être fini et supérieur ou égal à zéro afin qu'un vrai zéro-coupon soit autorisé. face_value (alias face, par et par_value) est le montant de remboursement ou au pair dans la même devise et doit être un nombre fini strictement supérieur à zéro. decimals est optionnel, un entier de zéro à douze (défaut six) qui pilote l'arrondi half-up du pourcentage et du taux décimal. En cas de succès le corps répète annual_coupon et face_value, puis coupon_rate en pourcentage, coupon_rate_decimal comme fraction équivalente et une chaîne formula qui reformule coupon_rate égal au coupon annuel sur le nominal fois cent. Exemple : cinquante de coupons annuels sur un nominal de mille renvoie coupon_rate cinq et coupon_rate_decimal zéro point zéro cinq. Champs manquants, valeurs non finies, coupon annuel négatif ou valeur nominale nulle ou négative échouent avec invalid_input en nommant le champ et ne sont pas facturés. Préférez des nombres JSON simples aux chaînes avec symboles monétaires ou signes de pour cent ; les chaînes numériques ne sont acceptées que si elles correspondent à un motif strict de nombre fini, sans virgules ni étiquettes. Le tarif est un $0.002 fixe par appel réussi avec unit item.

Où un calculateur de taux de coupon justifie sa place

Enseignants et plateformes LMS ont besoin d'un oracle pour la question de définition qui demande de calculer le taux de coupon à partir du coupon annuel et du nominal, y compris le cas zéro-coupon, sans terminal de données de marché. Les équipes de contenu peuvent opposer le taux de coupon au rendement courant et au YTM sur une obligation à escompte pour que le lecteur voie pourquoi trois pourcentages distincts peuvent décrire le même instrument. Utilisez cette capacité lorsque vous avez déjà les dollars de coupon annuel et le pair ; si vous avez un prix de marché et des années restantes et voulez le taux d'actualisation de détention jusqu'au remboursement, utilisez un calculateur de rendement à l'échéance plutôt que cette définition de coupon de l'acte. Les fichiers back-office stockent souvent l'encaisse de coupon annuelle et le nominal dans des colonnes distinctes ; un endpoint déterministe retrouve le pour cent sans une cellule de tableur que quelqu'un réécrirait plus tard en rendement courant en divisant par le prix de marché. Les intégrateurs branchent l'endpoint sur des carnets, des outils de flux ou des workers en bordure afin de figer les goldens dès qu'un extrait de portefeuille change l'encaisse de coupon ou le nominal stocké. Comme l'implémentation est un travail analytique parse de palier A pur, chaque appel réussi coûte le tarif de base publié $0.002 sans jetons de modèle ni réseau sortant. Gardez face_value strictement positif, figez les champs coupon_rate arrondis dans les tests, et vous obtenez des pourcentages de coupon reproductibles pour widgets, salles de classe et production sans monter votre propre bibliothèque de taux fixe.