Kuponsatz-Rechner

Ein Nennwert von null wird mit invalid_input abgelehnt, weil er kein Nenner sein kann.

Was der Kuponsatz bedeutet und wie der Jahreskupon über den Nennwert zum Prozent wird

Dieser Endpoint holt keine Live-Kurse, keine Day-Count-Kalender und keine Kreditspreads. Die Frequenz steckt bereits im Jahreskupon, den Sie senden: zahlt eine Anleihe fünfundzwanzig zweimal im Jahr, übergeben Sie fünfzig als annual_coupon, nicht die Periodenkasse. Der zurückgegebene coupon_rate ist das Prozent, das auf Term Sheets notiert wird; coupon_rate_decimal ist dasselbe Verhältnis als Bruch, sodass ein Fünf-Prozent-Kupon fünf und null Punkt null fünf ist.

Eingabevertrag, Antwortform und Fehlerverhalten

Der Nennwert ist das Feld, das der Produktvertrag hervorhebt: ein Nennwert null wird niemals still durch einhundert oder eintausend ersetzt, und ein fehlender Nennwert wird nicht als null behandelt. Fehlgeschlagene Validierung wird nicht berechnet, sodass Erkundungsskripte günstig bleiben, wenn Sie absichtlich einen Nennwert null senden, um den Fehlerpfad zu bestätigen. Senden Sie per POST einen JSON-Body mit zwei erforderlichen endlichen Zahlen. annual_coupon (Aliasse annual_coupon_payment, coupon_payment, coupon und annual_payment) ist die gesamte Kuponkasse, die die Anleihe in einem Jahr zahlt, in Währungseinheiten. Sie muss endlich und größer oder gleich null sein, damit eine echte Nullkupon-Anleihe zulässig ist. face_value (Aliasse face, par und par_value) ist der Tilgungs- oder Paribetrag in derselben Währung und muss eine endliche Zahl streng größer als null sein. decimals ist optional, eine Ganzzahl von null bis zwölf (Standard sechs) und steuert die Half-up-Rundung von Prozent und Dezimalsatz. Bei Erfolg spiegelt der Body annual_coupon und face_value, dann coupon_rate als Prozent, coupon_rate_decimal als gleichwertigen Bruch und eine Formelzeichenkette, die coupon_rate als Jahreskupon über Nennwert mal einhundert neu formuliert. Beispiel: fünfzig Jahreskupon auf Nennwert eintausend liefert coupon_rate fünf und coupon_rate_decimal null Punkt null fünf. Fehlende Felder, nicht-endliche Werte, ein negativer Jahreskupon oder ein Nennwert von null oder negativ scheitern mit invalid_input unter Nennung des Feldes und werden nicht berechnet. Bevorzugen Sie schlichte JSON-Zahlen gegenüber Zeichenketten mit Währungssymbolen oder Prozentzeichen; numerische Zeichenketten werden nur akzeptiert, wenn sie einem strengen Muster einer endlichen Zahl ohne Kommas oder Etiketten entsprechen. Der Preis ist ein festes $0.002 je erfolgreichem Aufruf mit unit item.

Wo ein Kuponsatz-Rechner seinen Nutzen zeigt

Lehrende und LMS-Plattformen brauchen ein Orakel für die Definitionsfrage, die den Kuponsatz aus Jahreskupon und Nennwert rechnen lässt, einschließlich des Nullkupon-Falls, ohne Markt-Daten-Terminal. Content-Teams können Kuponsatz, laufende Rendite und YTM an einer Diskontanleihe gegenüberstellen, damit Leser sehen, warum drei verschiedene Prozentsätze dasselbe Instrument beschreiben können. Nutzen Sie diese Fähigkeit, wenn Sie bereits Jahreskupon-Dollar und pari haben; wenn Sie einen Marktpreis und Restjahre haben und den Diskontsatz des Haltens bis zur Tilgung wollen, nutzen Sie einen Rechner für die Rendite bis Endfälligkeit statt dieser Urkunden-Kupondefinition. Back-Office-Dateien speichern oft Jahreskuponkasse und Nennwert in getrennten Spalten; ein deterministischer Endpoint holt das Prozent zurück, ohne eine Tabellenzelle, die jemand später als laufende Rendite umschreiben könnte, indem er durch den Marktpreis teilt. Integratoren verdrahten den Endpoint in Notebooks, Ablaufwerkzeuge oder Edge-Worker, um Goldens zu pinnen, sobald ein Portfolioauszug die gespeicherte Kuponkasse oder den Nennwert ändert. Weil die Implementierung reine Parse-Tier-A-Analytik ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Basispreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netz. Halten Sie face_value streng positiv, pinnen Sie die gerundeten coupon_rate-Felder in Tests, und Sie erhalten reproduzierbare Kuponprozente für Widgets, Hörsäle und Produktion, ohne eine eigene Fixed-Income-Bibliothek aufzubauen.