債券クーポンレート計算機

額面ゼロは分母にできないため invalid_input で拒否されます。

クーポンレートの意味と、年次クーポンを額面で割ってパーセントにする方法

本エンドポイントはライブ気配、デイカウント暦、クレジットスプレッドを取得しません。年二回二十五を払う債券なら、期ごとの現金ではなく五十を annual_coupon として送ってください。返す coupon_rate は条件書で引用されるパーセント、coupon_rate_decimal は同じ比の小数で、五パーセントのクーポンはそれぞれ五と 0.05 です。

入力契約、応答の形、エラー時の振る舞い

真のゼロクーポン債を許すため、有限かつゼロ以上でなければなりません。任意の decimals はゼロから十二の整数（既定六）で、パーセントと小数レートの half-up 丸めを制御します。額面は製品契約が特に強調する欄です。ゼロ額面が百や千に黙って置き換えられることはなく、欠落した額面もゼロ扱いされません。数値文字列はカンマやラベルのない厳密な有限数パターンに合うときだけ受け付けます。検証失敗は残高を消費しないので、エラー経路を確認するために意図的にゼロ額面を送る探索スクリプトも安く済みます。POST で JSON 本体に必須の有限数を二つ送ります。annual_coupon（別名 annual_coupon_payment、coupon_payment、coupon、annual_payment）は債券が一年に払うクーポン現金の合計で、通貨単位です。face_value（別名 face、par、par_value）は同じ通貨の償還額またはパー金額で、ゼロより厳密に大きい有限数でなければなりません。成功時は annual_coupon と face_value をエコーし、パーセントの coupon_rate、同等分数の coupon_rate_decimal、coupon_rate が年次クーポン÷額面×百であると述べる formula 文字列を返します。例：額面一千に対する年次クーポン五十は coupon_rate 五、coupon_rate_decimal は 0.05 です。欠落、非有限値、負の年次クーポン、ゼロまたは負の額面はフィールド名付きの invalid_input で失敗し課金されません。通貨記号やパーセント記号付きの文字列より素の JSON 数を使ってください。料金は成功呼び出しあたり固定の $0.002 で unit item です。

クーポンレート計算機が効く場面

教育者や LMS は、市場データ端末なしで年次クーポンと額面からクーポンレートを求める定義問題に、ゼロクーポンの場合も含む答え合わせが必要です。コンテンツチームはディスカウント債でクーポンレート、カレントイールド、満期利回りを対比し、同じ銘柄を三つの異なるパーセントが表し得る理由を読者に示せます。年次クーポンドルとパーがすでにあるときに本能力を使ってください。市場価格と残存年があり満期まで保有する割引率を求めるなら、証書のクーポン定義ではなく債券満期利回り計算機を使います。バックオフィスのファイルは年次クーポン現金と額面を別列に置くことが多く、決定論的なエンドポイントなら、誰かが後から市場価格で割ってカレントイールドに書き換えてしまう表セルなしでパーセントを戻せます。実装は純 parse ティア A の解析処理のため、成功呼び出しは公開の基本料金 $0.002 のみで、モデルトークンも外向きネットワークもありません。