ForHosting KIT · 開発者向けツール

普通年金の将来価値計算ツール

この普通年金の将来価値計算ツールでは、毎期末に同額を積み立て、その後一定の利率で運用した場合の成長額を確認できます。1回の積立額、1期間当たりの利率、積立回数をご入力ください。結果には拠出総額、得られた利息、最終的な将来価値が分けて表示されます。定期預金計画、投資見通し、事業用準備金など、期末に定額を積み立てる資金計画にご活用いただけます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

普通年金が表す内容

普通年金とは、連続する各期間の末日に同額を支払うキャッシュフローです。毎月末に行う貯蓄口座への振替が代表例です。最初の入金は後の入金より長く運用されるため、それぞれの入金が利息を得る期間は異なります。本ツールは、こうした個別の成長を一つの将来価値にまとめます。入力した積立額と期間数に加え、拠出総額、拠出額を上回る利息、最終残高を表示します。支払時期は重要です。この計算では、最初の期間の開始時点に支払いがないものとします。各期首に入金する場合は期首払い年金となり、利率が正なら将来価値はより大きくなります。支払間隔と利率の期間は必ず合わせてください。毎月積み立てる場合は月利、毎年積み立てる場合は年利をご入力ください。年率から期間利率への自動変換は行わないため、入力値は1回の支払期間に対応する利率である必要があります。

将来価値の計算方法

期間利率が正の場合は、普通年金の標準式を使用します。1に期間利率を加えた値を期間数で累乗し、1を引いて期間利率で割り、その係数を積立額に掛けます。利率はパーセントで入力し、計算時に小数へ変換します。利率がゼロの場合は割り算が定義できないため、将来価値を積立額と期間数の積として正しく求めます。小さな利率や長期計画でも不要な浮動小数点誤差を抑えるよう、数値的に安定した対数関数と指数関数を使用しています。金額は全計算の後にのみ丸め、初期値は小数第2位、指定範囲は0桁から10桁です。拠出総額は積立額と期間数の積、利息は将来価値から拠出総額を引いた値です。結果は、固定利率、同額かつ期日どおりの支払い、利息の再投資を前提とし、税金、手数料、未払い、引き出し、利率変更は含みません。そのため、投資成果を保証するものではありません。

入力値の選び方と結果の読み方

まず、1期間が表す正確な間隔をお決めください。次に、その間隔の末日に支払う金額、同じ間隔に適用される実効利率、支払総回数をご入力ください。たとえば、10年間に毎月積み立てる計画は120期間です。名目年率しか分からない場合は、月次計画に使用する前に口座の複利規則に従って換算してください。単純に12で割った値が商品の実効月利と一致するとは限りません。拠出総額と将来価値を比較すると、最終残高のうち入金による部分と複利による部分を把握できます。慎重な利率と楽観的な利率で再計算すれば、長期計画が想定収益率にどの程度左右されるかも確認できます。シナリオ間の差が大きいほど、長期予測の不確実性に注意が必要です。小数桁の設定は他システムとの照合に役立ちますが、表示桁数を増やしても前提の精度は上がりません。無理なく継続できる積立額をお選びください。

活用例

定期積立を予測する

毎月または毎年の同額入金による残高を見積もり、元本と複利成長を分けて確認できます。

積立条件を比較する

積立額、利率、期間を変えて、最終価値に最も影響する条件を把握できます。

事業準備金を試算する

利息が付く準備金口座へ各期末に定額を移す場合の累積価値を予測できます。

よくある質問

計算料金はいくらですか？

ブラウザー版は無料です。APIリクエスト1回の料金は$0.002です。

普通年金と期首払い年金の違いは何ですか？

普通年金は期末、期首払い年金は期首に支払うため、後者では各支払いが1期間長く運用されます。

年利と月利のどちらを入力しますか？

1回の支払期間に対応する利率をご入力ください。月次なら月利、年次なら年利です。

利率がゼロの場合はどうなりますか？

将来価値は積立額と期間数の積になり、利息はゼロです。

既存の開始残高も結果に含まれますか？

含まれません。同額の支払いのみを評価します。開始残高の将来価値は別途計算して加算してください。

開発者向け — APIアクセス

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

エンドポイント

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

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

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

curl -X POST https://api.kit.forhosting.com/finance/future-value-annuity-ordinary \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payment":500,"periodic_rate_percent":0.5,"periods":120}'

const res = await fetch("https://api.kit.forhosting.com/finance/future-value-annuity-ordinary", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "payment": 500,
    "periodic_rate_percent": 0.5,
    "periods": 120
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/future-value-annuity-ordinary",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "payment": 500,
    "periodic_rate_percent": 0.5,
    "periods": 120
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/future-value-annuity-ordinary", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"payment":500,"periodic_rate_percent":0.5,"periods":120}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"payment":500,"periodic_rate_percent":0.5,"periods":120}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/future-value-annuity-ordinary", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "payment": 500,
  "periodic_rate_percent": 0.5,
  "periods": 120
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.future_value_annuity_ordinary",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

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