ForHosting KIT · 開発者向けツール

老後資金の積立不足額計算ツール

現在の残高から将来の目標額までを結ぶ計画がなければ、老後資金の目標だけを見ても十分な判断はできません。この計算ツールは、現在の資産と予定している年間積立額を退職時点まで運用した場合の金額を求め、不足額を一定の年間追加積立額に換算します。想定利回りはプラス、ゼロ、または一定範囲のマイナスに対応し、積立時期も年初と年末から選べます。予想残高、不足額、必要な年間積立総額をまとめて確認できます。

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

無料で実行 API仕様を見る

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

将来の目標を毎年の具体的な行動に変えます

目標残高だけでは、今から何をすべきかは分かりません。現在の老後資金、すでに予定している年間積立額、退職時に必要な残高、退職までの満年数、想定する実効年利をご入力ください。まず現在の資産を退職時点まで複利運用した金額を計算します。次に、予定する各年の積立金の将来価値を求め、両者を合計します。その予想残高が目標を下回る場合、差額が貯蓄不足額です。同じ利回りと積立時期を前提として、この将来の不足額を残りの各年に均等な追加積立額へ換算します。結果では、すでに予定している額を含む必要年間積立総額と、追加で必要な年間積立額を分けて表示します。予想残高が目標以上であれば、不足額と追加積立額はいずれもゼロになります。

利回りと積立時期の前提をご確認ください

このモデルでは、計算期間を通じて一定の実効年利を使用します。これは計画上の仮定であり、将来の予測や保証ではありません。実際の運用成績は変動し、手数料、税金、物価上昇、引き出しによって結果も変わります。積立時期も結果に影響します。年末を選ぶと、その年の運用後に入金する通常年金方式として計算され、比較的慎重な想定になります。年初を選ぶと、各年の積立金が年の初めから運用されるため、1年分多く成長します。利回りがゼロの場合は複利効果がなく、追加額は不足額を残存年数で割った金額です。マイナス100パーセントを上回る負の利回りにも対応しますが、現在資産と積立金の将来価値はいずれも減少します。内訳を表示するため、計算根拠も確認できます。

1つの答えではなく複数のシナリオを比較します

老後の計画では、正確に見える1つの数字よりも複数の条件による幅を確認することが大切です。まず標準的な利回りで計算し、次に低い利回り、短い積立期間、または年末積立でもお試しください。追加年間積立額の変化から、ご自身では完全に管理できない前提に計画がどれほど左右されるかを把握できます。生活費の高い老後を想定して目標を増やしたり、支出の見直し後に目標を下げたりすることもできます。通貨換算は行わないため、すべての金額には同じ通貨をお使いください。残高、積立額、退職時期、目標が変わった際は再計算してください。API は1回 $0.002、ブラウザーでは無料です。税務、口座制度、リスク許容度、目標の妥当性については、必要に応じて専門家へご相談ください。

活用例

年間貯蓄計画を更新します

新しい残高を確認したときや、退職までの期間または目標を変更したときに、追加積立額を再計算できます。

退職資金予測を厳しい条件で検証します

慎重な利回りと楽観的な利回りを比較し、必要な年間積立額がどの程度変わるかを確認できます。

資金計画ソフトに不足確認を追加します

API の決定論的な結果を使い、予想残高、不足額、必要な年間対応額を表示できます。

よくある質問

計算ツールの料金はいくらですか？

API は1回 $0.002 です。このページではブラウザー上で無料でもご利用いただけます。

予想残高がすでに目標を上回る場合はどうなりますか？

不足額と追加年間積立額はゼロになります。予想残高は引き続き表示され、目標達成済みであることも確認できます。

積立時期は年初と年末のどちらを選べばよいですか？

各年の初めに全額を投資する場合は年初を、年の終わりに入金する場合や通常年金方式を使う場合は年末をお選びください。

想定利回りには物価上昇が含まれますか？

自動では含まれません。名目利回りには名目目標額を、実質利回りには現在の購買力で表した目標額を組み合わせてください。

毎月の積立も計算できますか？

いいえ。この機能は年1回の一定積立をモデル化します。年間換算が適切な場合に限り、毎月の貯蓄額を年間額へ換算してください。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/finance/retirement-contribution-gap

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

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

curl -X POST https://api.kit.forhosting.com/finance/retirement-contribution-gap \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"current_savings":150000,"annual_contribution":12000,"target_savings":1000000,"years_to_retirement":25,"annual_return_percent":6}'

const res = await fetch("https://api.kit.forhosting.com/finance/retirement-contribution-gap", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "current_savings": 150000,
    "annual_contribution": 12000,
    "target_savings": 1000000,
    "years_to_retirement": 25,
    "annual_return_percent": 6
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/retirement-contribution-gap",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "current_savings": 150000,
    "annual_contribution": 12000,
    "target_savings": 1000000,
    "years_to_retirement": 25,
    "annual_return_percent": 6
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/retirement-contribution-gap", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"current_savings":150000,"annual_contribution":12000,"target_savings":1000000,"years_to_retirement":25,"annual_return_percent":6}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"current_savings":150000,"annual_contribution":12000,"target_savings":1000000,"years_to_retirement":25,"annual_return_percent":6}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/retirement-contribution-gap", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "current_savings": 150000,
  "annual_contribution": 12000,
  "target_savings": 1000000,
  "years_to_retirement": 25,
  "annual_return_percent": 6
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.retirement_contribution_gap",
  "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の完全なドキュメントを見る →