ForHosting KIT · 金融・お金

年金将来価値の計算

毎月末に200を月1%で積み立てると、12回目の積立直後の残高は2,536.5です。積立計画の見通し、決まった支出への備え、パンフレットの数字の確認に使えます。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
支払額
200
期間あたりの利率
0.01
期間数
12
結果
将来価値
2,536.5

毎期末に同じ金額を積み立て、期間ごとに一定の利率で運用した場合、最後の積立の直後にいくらになるのでしょうか。貯蓄プランの試算、将来の支出に備えた減債基金の規模設定、定期的な投資拠出の増加額の見積もり、あるいはパンフレットの試算の検算にご利用いただけます。スプレッドシートも登録も不要な、決定論的な1回の呼び出しです。

年金の将来価値とは何か

年金とは、一定間隔で行われる等額の支払いの流れであり、その将来価値とは、各支払いが運用されていた期間に応じて利息を得たうえで、その流れが最終時点でいくらの価値を持つかを示すものです。毎月末に 200 を月利 1% で積み立てると、最初の積立は 11 か月間、2 回目は 10 か月間複利で運用され、最後の積立には利息が付きません。

将来価値とは、こうして増えたすべての支払いの合計です。閉形式の公式、将来価値 = 支払額 x (((1 + r)^n - 1) / r) は、この合計を一つの式にまとめたものであり、年金基金、銀行、金融の教科書で使われているものと同じ公式です。利率が期間あたりで表されるため、月利と月次積立、年利と年次積立など、どのような頻度の組み合わせでも計算できます。

重要なのは一貫性です。 利率と期間数は同じ間隔を表している必要があります。年利を送りながら積立回数を月次で数えれば、試算は構造的に誤りとなり、どんな計算機でも単位の不一致を救うことはできません。両者をそろえれば、結果は正確で決定論的であり、どのマシンでも再現可能です。

だからこそ、同じ計算がお客様のブラウザと当社のエッジでまったく同一に実行されるのです。

入力、単位、エッジケース

支払額は各期末に積み立てる金額で、貯蓄の拠出、減債基金の積立、定期的な投資などを想定しており、正の値である必要があります。期間利率は小数で表し、月利 1% は 1 でも 0.01% でもなく 0.01 です。期間数は支払いの回数で、1200 までの正の整数である必要があります。

これは 100 年分の月次積立を十分にカバーします。2 つのエッジケースは意図的に処理されています。利率ゼロは有効で、成長のない純粋な累積を意味します。

将来価値は支払額に期間数を掛けたものと厳密に一致し、これは利率がゼロに近づくときの公式の数学的に正しい極限です。そのため、ゼロ除算で失敗させるのではなく、そのまま返します。また、返される将来価値は小数点以下 2 桁(銭の位)に丸められ、実行間およびマシン間でバイト単位の応答の安定性が保たれます。

この安定性は見た目の問題ではありません。お客様のシステムで試算をキャッシュしたり照合したりする際にも、同じことができます。

効果的な使い方と、できないこと

典型的な用途は 3 つのパターンに分かれます。フィンテックや銀行のプロダクトは、定期的な積立プランがいくらに増えるかを利用者に示すために呼び出します。将来の残高こそが習慣を動機づける数字だからです。

財務チームはこれを使って減債基金の規模を決めます。既知の将来の債務に対し、定期的な積立がいくら累積するかを計算し、目標に達するまで支払額を調整します。そしてプロダクトチームは、独自の目標計算機の背後に組み込み、計算ロジックを一か所で保守できるようにします。

各フロントエンドで誤って再実装されることを避けるためです。返すのは将来価値のみであり、拠出と利息の内訳を含む期間ごとの増加表は生成しません。また、各期末に積み立てる普通年金を前提としており、期首に積み立てる期首年金は追加で (1 + r) の係数だけ増加します。

さらに、手数料、税金、インフレ、拠出額の変動のない一定利率をモデル化しています。お客様のケースが単純な累積モデルに合う場合、これは適切なツールです。合わない場合は、ここで基礎となる値を計算し、追加分はお客様のコードで実装してください。

貯蓄プランの試算

お客様がプランに確定する前に、毎月の定額積立が選択した期間と想定利率でいくらに増えるかを示します。

減債基金の規模設定

設備、税金、一括返済など、既知の将来の支出が期日までにまかなえるよう、定期的な積立の累積額を計算します。

定期投資の見積もり

想定した期間リターンで、投資口座への等額の定期拠出が最終的にいくらになるかをモデル化します。

利率はパーセントですか、小数ですか?

期間あたりの小数です。 0.01 は期間あたり 1% を意味します。年率のパーセントは 100 で割り、さらに 1 年あたりの期間数で割ってください。

利率 0% の場合はどうなりますか?

対応しています。 将来価値は支払額に期間数を掛けたものになり、これは利息ゼロにおける公式の厳密な極限です。

期間ごとの増加表は返りますか?

いいえ。 最終的な累積額のみを返します。期間ごとの内訳は別の機能です。

期首年金ですか、普通年金(期末払い)ですか?

普通年金です。 各期末に支払いが行われることを前提としています。期首年金の場合は、結果に (1 + 利率) を掛けてください。

最初の積立が最後の積立より多く増えるのはなぜですか?

各積立は入金した時点から利息が付くためです。毎月末に積み立てる場合、最初の積立は11か月分の複利で増え、最後の積立には利息が付きません。

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

POSThttps://api.kit.forhosting.com/fin/annuity-future-value

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

curl -X POST https://api.kit.forhosting.com/fin/annuity-future-value \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payment":200,"rate_per_period":0.01,"periods":12}'
{
  "payment": 200,
  "rate_per_period": 0.01,
  "periods": 12
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.annuity_future_value",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

1リクエストあたり$0.002

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

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

年金将来価値 API は、資産形成の根本的な問いに答えます。本 API は閉形式の累積公式を適用し、将来価値という単一の数値を、支払額と同じ通貨単位で返します。

入力、単位、エッジケース

このエンドポイントは 3 つの数値を受け取ります。また、負でない値である必要があり、負の利率は invalid_input エラーで拒否され、課金されることはありません。負の期間数は意味をなさず、invalid_input で拒否されます。

効果的な使い方と、できないこと

このエンドポイントが意図的に省いている点を明確にしておきます。これらの省略があるからこそ、高速で、1 リクエスト $0.002 と安価で、正確に予測可能なのです。

料金はいくらですか。

API 経由では 1 リクエストにつき $0.002 です。このページのブラウザ上では無料で実行できます。

期間数が負の場合はどうなりますか。

リクエストは invalid_input エラーで失敗し、課金されません。負の期間数はこのモデルでは意味を持ちません。

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