ForHosting KIT · 開発者向けツール

将来価値から定期積立額を求める計算ツール

この計算ツールでは、目標残高を積み立てるために毎期必要となる一定額を求められます。将来価値、1期間当たりの利率、期間数、期首または期末の入金時点をご指定ください。結果には積立元本と運用益が分けて表示されるため、老後資金、予備費、設備更新費など、定期的な積立で達成する資金計画に役立ちます。

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

無料で実行 API仕様を見る

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

利率と積立期間の単位をそろえてください

最も重要な入力は期間利率です。積立の間隔および期間数と同じ単位で指定する必要があります。毎月積み立てる場合は月利を入力し、期間数も月数で数えてください。四半期ごとの積立なら、四半期利率と四半期数を使用します。月数を指定しながら年利をそのまま入力すると、単位が混在して誤解を招く積立額になります。名目年利を毎月複利で運用する場合は、一般に年利を12で割ります。実効年利から同等の月利を求める場合は、1に年利を加えた値の12乗根から1を引きます。本ツールが期間利率を直接求めるのは、特定の換算方法を暗黙に選ばないためです。利息が付かない場合は0を入力してください。その場合、必要額は目標額を積立回数で割った値になります。通貨換算は行わないため、目標額と積立額には同じ通貨をお使いください。

期末払いと期首払いの違いをご確認ください

各期間が終わった後に入金する通常年金では「期末」を選択します。月末の給与から積み立てる場合や、各会計期間の終了後に準備金へ繰り入れる場合などが該当します。各期間の開始時に入金する期首払い年金では「期首」を選択してください。利率が正の場合、期首の入金は1期間長く利息を得られるため、必要な積立額は低くなります。計算では、まず期末払いが将来価値へ積み上がる係数を求めます。期首払いの場合は、その係数にさらに1期間分の成長を反映し、該当する係数で目標額を割ります。利率が高く期間が長いほど、両者の差は大きくなります。小さい結果を選ぶのではなく、実際の資金移動日程に合わせてご指定ください。利率が0なら、入金時点による数値の差はありません。

結果を読み取り、前提条件も検証してください

定期積立額は、ご指定の条件の下で毎期同額を入金したときに必要となる数学上の金額です。積立元本合計は定期積立額に期間数を掛けた値で、運用益は目標将来価値から元本合計を引いた値です。固定利率が正なら、運用益が差額を補うため、元本合計は目標額より少なくなります。自動処理でも精度を保てるよう、結果には通常の通貨表示より多くの小数桁を残しています。実際の入金を最小通貨単位に丸める必要がある場合は、切り上げるほうが安全です。切り捨てるとわずかに不足する可能性があります。この計算は、利率が一定で、全額が予定どおり入金され、各期間に1回複利計算され、税金、手数料、引き出し、開始残高がないことを前提とします。単一の予測を保証とみなさず、低い利率と高い利率でも試算してください。実際の運用では残高を目標経路と定期的に比較し、実績や日程が変われば残りの積立額を再計算することをおすすめします。

活用例

老後資金の積立額を決める

一定の月数または年数で希望残高を築くために必要な定期拠出額を見積もれます。

設備更新の準備金を積み立てる

将来の購入額を均等な定期入金へ換算し、準備金から得られる利息も反映できます。

学費や住宅頭金を計画する

期間、期間利率、期首・期末の入金条件を変えて、必要な積立額を比較できます。

よくある質問

このツールは何を求めますか？

開始残高を0として、指定した将来価値に到達するために毎期入金する同額の積立金を計算します。

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

積立間隔と同じ期間の利率をご入力ください。毎月の積立では月利を使い、期間数も月単位で指定します。

期首と期末はどのように違いますか？

期末は各期間の終了後に入金します。期首は1期間早く入金するため、追加の1期間にわたり運用されます。

既存の残高も計算に含まれますか？

いいえ。開始残高は0とし、同額の積立だけを計算します。既存残高にも利息が付く場合、目標額から単純に差し引く方法は正しくありません。

運用益が負になることはありますか？

対応する利率は0以上のため、大きな負の値にはなりません。表示上の丸めによってごく小さな差が出る場合があります。

利用料金はいくらですか？

ブラウザーの計算ツールは無料です。APIリクエストは1回$0.002です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/finance/annuity-payment-from-fv

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

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

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

const res = await fetch("https://api.kit.forhosting.com/finance/annuity-payment-from-fv", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "future_value": 100000,
    "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/annuity-payment-from-fv",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "future_value": 100000,
    "periodic_rate_percent": 0.5,
    "periods": 120
},
)
task_id = res.json()["task_id"]

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

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

リクエスト例

{
  "future_value": 100000,
  "periodic_rate_percent": 0.5,
  "periods": 120
}

レスポンス例

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