ForHosting KIT · 金融・お金

債券利回り計算機

額面1,000、クーポン5パーセント、残り10年の債券を1,000で買うと、満期利回りはちょうど5パーセントです。額面どおりの価格なら利回りはクーポンと同じになります。ご自身の価格を入れれば割引や割増の影響が分かります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

額面金額: 1,000
クーポンレート: 5
現在価格: 1,000
満期までの年数: 10

結果

クーポン支払額: 50
利回り (%): 5
利回り (小数): 0.05
直接利回り (%): 5

債券の満期利回りは、残りのクーポンと額面償還の現在価値を、本日お支払いになる価格と一致させる唯一の年率です。学習者・アドバイザー・プロダクトチームは、表計算や本格的な債券ライブラリを開かずに、額面・クーポン率・現在価格・残存年数の四つの数からその率を必要とします。本債券利回り計算機は年次クーポンの古典恒等式を y について解き、年率利回りをパーセントと小数で返し、年次クーポン額と直接利回り（クーポン÷価格）も示します。

債券の満期利回りが意味すること

満期利回りは、クーポン債の残キャッシュフローの現在価値を、本日お支払いになる市場価格と一致させる唯一の一定年率です。そのキャッシュフローは、額面にクーポン率（パーセント）を掛けて百で割った年次クーポンを残存期間に年1回支払うものと、満期に返済される額面（パー）です。

満期まで保有し、クーポンを同じ率で再投資し、予定どおり額面を受け取れば、実現する年率リターンはこの計算機が示す利回りに一致します。パーで取引されるときは現在価格が額面に等しく、利回りはクーポン率に等しくなります。ディスカウントで取引されるときは価格が額面を下回り、利回りはクーポンを上回ります。

保有者はパーへの収束も得るからです。プレミアムで取引されるときは価格が額面を上回り、利回りはクーポンを下回ります。各クーポンの一部がパーへ向けた減価で相殺されるからです。

ゼロクーポン債はクーポン率がゼロの特例で、キャッシュフローは満期の額面のみであり、利回りは価格から額面への年率ディスカウントです。直接利回りは別の単純な比（年次クーポン÷現在価格）であり、パーまでの損益は含めません。モデルは年次複利と年次クーポン年金を用い、デイカウント規約、地方債の半年引用、ダーティ対クリーン、信用スプレッド分解は適用しません。

学習者・アドバイザー・商品ページが「債券利回り」や「満期利回り」として探す核心の問いに答えます。額面・クーポン・価格・年数が与えられたとき、年率利回りはいくらか、です。

債券利回り計算機が役立つ場面

パー・ディスカウント・プレミアム・ゼロクーポンの各ケースを含みます。資産・財務・仲介のツールは、満期日程がまだ載っていないときや、商品ランディングに額面・クーポン・価格・残存年数しかないとき、画面価格の横に単純な年率利回りを出すことがよくあります。

面接・宿題ジェネレータは、誤った利回りをマークし、正でない現在価格を拒否する決定論的オラクルを必要とし、NaN や静かな空オブジェクトは返しません。本ツールはマコーレー・デュレーション、修正デュレーション、凸性、半年債相当利回り、マルチカーブ割引は出しません。入力した価格にクーポン債の現在価値を一致させる年次複利の利回りだけです。

単純な年率の債券利回りの問いに使い、より豊かな分析は必要なら自サービスに重ねてください。

活用例

教室・試験の検算

額面・クーポン・価格・年数から、パー・ディスカウント・プレミアム・ゼロクーポン債の教科書どおりの満期利回りを検証します。

よくある質問

債券の満期利回りはどう計算しますか？

計算機は年率 y について P = C*((1-(1+y)^(-n))/y)+F/(1+y)^n を解きます。ゼロクーポンは y = (F/P)^(1/n) − 1 です。パー債（価格＝額面）はクーポン率になります。

現在価格がゼロまたは負だとどうなりますか？

正でない市場価格では満期利回りは定義されず、検証失敗は課金されません。

額面より安い債券の利回りがクーポンより高くなるのはなぜですか？

クーポンに加えて、安い購入価格と満期に戻る額面との差も受け取れるためです。額面より高い場合は逆に、その差損が毎年のクーポンの一部を打ち消すため、利回りはクーポンより低くなります。

満期利回りと直接利回りはどう違いますか？

直接利回りは、年間のクーポンを今日の価格で割っただけの数字です。満期までに価格が額面へ戻る分の損益は含まれず、満期利回りはそれも含みます。両方が表示されるので差を確かめられます。

ゼロクーポン債の利回りも計算できますか？

できます。クーポン率にゼロを入れてください。受け取るのは満期の額面だけになるため、今日の価格が残りの年数で額面に育つ年率が利回りになります。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/fin/bond-yield

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/fin/bond-yield \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"face_value":1000,"coupon_rate":5,"current_price":950,"years_to_maturity":10}'

const res = await fetch("https://api.kit.forhosting.com/fin/bond-yield", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "face_value": 1000,
    "coupon_rate": 5,
    "current_price": 950,
    "years_to_maturity": 10
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/bond-yield",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "face_value": 1000,
    "coupon_rate": 5,
    "current_price": 950,
    "years_to_maturity": 10
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/bond-yield", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"face_value":1000,"coupon_rate":5,"current_price":950,"years_to_maturity":10}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"face_value":1000,"coupon_rate":5,"current_price":950,"years_to_maturity":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/bond-yield", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "face_value": 1000,
  "coupon_rate": 5,
  "current_price": 950,
  "years_to_maturity": 10
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.bond_yield",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

正でない現在価格は invalid_input で拒否され、課金されません。

債券の満期利回りが意味すること

本エンドポイントは両方を返し、差が見えるようにします。

入力契約・式・応答フィールド

クーポンがゼロのときは閉形式 y＝(額面÷価格)^(1/n)−1 に落ちます。価格が額面に等しいとき、y はクーポン率の小数です。ソルバーは平均クーポン＋償却の標準初期値から Newton 反復し、必要なら y が −1 より大きい範囲で有界な二分法を使い、時計や乱数に依存しない決定論的な結果にします。例：額面1000、クーポン5、価格1000、年数10は満期利回り5パーセントと直接利回り5パーセントを返します。パー恒等式です。必須の有限数4つを JSON 本体で送ってください。face_value は満期に返済されるパー金額で、ゼロより大きくなければなりません（別名: face, par, par_value）。coupon_rate は年次クーポンをパーセントで表したもので、5 は年5パーセントであり小数ではなく、ゼロ以上でなければなりません（別名: coupon, coupon_percent）。current_price は額面と同じ通貨単位の現在市場価格で、厳密に正でなければなりません。ゼロまたは負の価格は current_price を指名する invalid_input で拒否され、課金されません（別名: price, market_price）。years_to_maturity は残存年数で、ゼロより大きく最大200です。端数年も許可され、残りの6か月は 0.5 と入力できます（別名: years, maturity, n）。エンジンは年次クーポン C を face_value×coupon_rate÷100 とし、価格＝C×(1−(1+y)^(−n))÷y＋額面÷(1+y)^n を未知の年率 y について解きます。応答は4入力に加え coupon_payment、yield_percent（y×100、half-up で小数6桁）、yield_decimal（y を half-up で小数8桁）、current_yield_percent（クーポン÷価格×100）、短い formula 文字列を返します。欠落フィールド、空文字、非有限、正でない現在価格、負のクーポン率、許容範囲外の年数は invalid_input で失敗します。

債券利回り計算機が役立つ場面

債券利回り計算機や満期利回り計算機で順位を狙うコンテンツサイトは、同じ同型モジュール上で有料自動化と一致する無料ブラウザ経路の恩恵を受け、注目スニペットと API クライアントが食い違いません。自前コードで current_price や years_to_maturity をループし、固定クーポンの価格・利回り曲線を作り、テストで yield_percent を固定し、リクエストは小さく保ってください。

連携の活用例

価格・利回りシナリオの掃引

current_price や years_to_maturity をループし、完全な債券ライブラリなしで固定クーポンの単純な年次利回り曲線を構築します。

商品・ポートフォリオウィジェット

計算機ページやオンボーディングで、提示された画面価格の横に年率の満期利回りを投資家へ示します。

技術的な質問

クーポン率・価格・満期にはどの単位を使いますか？

coupon_rate は年あたりのパーセントです（5 は 5% であり 0.05 ではありません）。current_price と face_value は同じ通貨単位です。years_to_maturity は年単位で端数可（6か月は 0.5）です。

直接利回りは満期利回りと同じですか？

いいえ。current_yield_percent は年次クーポンを現在価格で割ったものです。yield_percent は、本日の価格から満期の額面までの損益も含めた内部収益率です。

債券利回り計算機の料金は？

ブラウザツールは無料です。API は成功1回あたり $0.002 の KIT 前払い残高を使い、無効入力は課金されません。

KITの完全なドキュメントを見る →

債券利回り計算機

無料で実行

計算例

債券の満期利回りが意味すること

債券利回り計算機が役立つ場面

活用例

教室・試験の検算

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

債券の満期利回りが意味すること

入力契約・式・応答フィールド

債券利回り計算機が役立つ場面

連携の活用例

価格・利回りシナリオの掃引

商品・ポートフォリオウィジェット

技術的な質問

ありがとう