債券直利計算

エンジンは純粋な決定論的算術であり、宿題の解答、スクリーニング用表、APIクライアントは同じ入力で必ず一致します。

直利が測るものと計算方法

ここで用いる標準の恒等式は、current_yield_percent が annual_coupon を market_price で割り、百を掛けたものです。百を掛ける前の同じ比が current_yield_decimal であり、六点三二パーセントの直利は購入価格の毎年およそ 0.0632 でもあります。年間クーポンが厳密に正のとき、応答には inverse_yield も含まれます。これは market_price を annual_coupon で割った値で、クーポンが変わらないと仮定したときに市場価格を回収するのに要する年数、すなわち小数直利の逆数です。クーポンゼロは直利ゼロとなり、inverse_yield は null ではなく省略されます。任意の face_value（額面）を渡すと、エンジンは coupon_rate_percent、額面に対するドルのプレミアムまたはディスカウント、quote_vs_par（premium、par、discount）、および yield_versus_coupon も報告し、教科書の関係が見えます。

入力、検証、丸め、および応答の内容

年間クーポンはゼロクーポン債を表すためにゼロでもよく、その場合は直利ゼロパーセントになります。市場価格は厳密にゼロより大きくなければなりません。ゼロまたは負の価格は利回りとして未定義であり、同じように拒否されるので、自動化が Infinity を保存することはありません。小数利回りは min(precision 足す四、十五) に丸められるため、九十四ベーシスポイントのような小さい利回りでも小数点以下の余分な桁が残ります。成功応答は二つの入力、百分率の直利、小数直利、公式文字列、使用した精度をエコーします。CUSIP や生きたティッカー記号は送らないでください。annual_coupon と market_price は、同じ通貨単位の必須の有限数です。負のクーポンは、そのフィールド名を示す型付き invalid_input を返します。この契約では負のクーポンから現金利回りを求めないためです。任意エイリアス coupon、coupon_payment、annual_coupon_income、c は annual_coupon に、price、current_price、bond_price、dirty_price は market_price に対応し、表計算やフォームが使い慣れた列名を再利用できます。任意の face_value（エイリアス par、par_value、face、nominal、face_amount）は送る場合に厳密に正でなければならず、額面に対するクーポンレートの計算と気配の分類にだけ使います。任意の precision フィールド（エイリアス decimals、dp）は金額・百分率・inverse_yield の小数桁を制御し、既定四桁・上限十五桁で安定した JSON にします。検証失敗は課金されず、成功した API タスクのみ公表の基本料金 $0.002 で前払い残高を消費します。本エンジンは気配、経過利息、クーポンカレンダーを照会せず、数値でない識別子は invalid_input になります。

債券直利計算が役立つ場面

インカム投資家や債券スクリーナーは、端末が直利列を更新するのを待たずに、価格変動後の利付債比較に直利計算を使います。地方債クーポンと課税利回りの税引後比較が必要な場合は課税相当利回りの別ツールを、株式の現金利回りが必要な場合は配当利回りツールをご利用ください。本ページは年間クーポン収入を現在の市場価格で割る結果だけを、テストで信頼できる安定した再現可能な出力で返します。残存期間にわたる額面への回帰を気にする場合の最終利回りの代用にはなりません。年間クーポンが変わらず市場価格が下がれば直利は上がり、回収までの inverse_yield 年数は短くなります。助言者や教員は、見出しの高い直利がクーポン増ではなく価格下落の産物であり得ることを、annual_coupon を固定し market_price だけ変え、face_value を加えてディスカウント気配がクーポンレートより上に来ることを示して説明します。表計算利用者は表示コードを改修するとき、六十対九百五十が 6.3158 パーセントになる結果を継続的インテグレーションに固定し、丸めとエイリアスが壊れないことを確かめます。純粋な parse の tier A であるため、成功した呼び出しは毎回公表の基本料金 $0.002 で、モデルトークンも外向きネットワークもなく、無効入力は課金されず、応答後に何も保存されません。単一気配の確認には無料の対話ページを、一括スクリーニングには有料エンドポイントを組み合わせてください。