ForHosting KIT · 金融・お金

貯金計算機

Q: 利率はパーセントですか、小数ですか？

パーセントです。 年五パーセントなら 5 を送ってください。0.05 を送ると五パーセントではなく、パーセントの百分の五として扱われます。

1,000から始めて毎月100を年利5%で10年間積み立てると、残高は17,175.24で、うち13,000が自分のお金、4,175.24が利息です。利息は毎月複利で付きます。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

預入額: 1,000
月額: 100
金利: 5
年数: 10

結果

月数: 120
月利: 0.0041666667
最終残高: 17,175.24
拠出総額: 13,000

貯金計算機は一つの家計の問いに答えます。初回預入から始め、毎月一定額を足し、年率の利息を何年か得たとき、残高はいくらになるか。この貯金計算機は初回預入、毎月積立、年率パーセント、年数の四数を受け取り、月次複利のあとの最終残高を返します。目標額から必要な毎月額への逆算、通貨換算、別名の投信 SIP の投影は行いません。

貯金の成長の意味と閉じた式の働き

この計算機の貯金計画には、同じ名目年率の下で複利になる二つのキャッシュフロー形があります。初回預入は地平の始めに付けられる一回の額です。毎月積立は地平の全期間、各月末に付けられる一定額です。

年パーセントを百で割り、さらに十二で割って月利率 i にします。月数 n は年での地平の十二倍です。預入は P に一プラス i の n 乗を掛けたものとして増え、これは元本の通常の月次複利です。

積立は月末払いの通常年金として扱います。PMT に、一プラス i の n 乗から一を引いて i で割った量を掛けます。年率がゼロなら月利率もゼロでその年金比は未定義になるため、積立の将来価値は PMT 掛ける n に落ち、単に入れた現金です。

最終残高は二つの部分の和です。拠出合計は預入に PMT 掛ける n を足したもの、利息は最終残高からその現金を引いたものです。このページは元本だけの複利でも、期首払いの年金満期同一性でも、目標までの月数を逆算する道具でもありません。

それらの検索には既に別の計算機があります。表計算が複利の約束を黙って変えるかもしれないのに対し、純粋な parse の恒等式にする理由がそこにあります。

活用例

緊急資金と住宅頭金の投影

今日付けた開始預入と、宣言した年率と地平での毎月定額振込を合わせた残高を投影します。

教室と助言の神託

最終残高を拠出した現金と得た利息に分け、学習者が各部分を確かめられる再現可能な貯金の解答キーを作ります。

よくある質問

貯金の最終残高はどう計算しますか？

預入は P×(1+i)^n で増えます。毎月積立は月末払いの通常年金 PMT×[((1+i)^n−1)/i] で、i がゼロのときは PMT×n です。最終残高はその二つの和です。

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

パーセントです。年五パーセントなら 5 を送ってください。0.05 を送ると五パーセントではなく、パーセントの百分の五として扱われます。

利率や期間が負だとどうなりますか？

負の年率や負の年数は拒まれ、課金されません。利率ゼロと年数ゼロは許されます。

毎月積立は各月の初めと終わりのどちらに付きますか？

各月末です（通常年金）。月初の期首払い年金の恒等式は別の契約です。

目標額から毎月の積立額を逆算できますか？

いいえ、できません。初回預入、月額、年利、年数から最終残高を求める一方向の計算です。目標額から必要な月額を求めるのは別の計算になります。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/fin/savings

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

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

curl -X POST https://api.kit.forhosting.com/fin/savings \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deposit":1000,"monthly":100,"rate":5,"years":10}'

const res = await fetch("https://api.kit.forhosting.com/fin/savings", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "deposit": 1000,
    "monthly": 100,
    "rate": 5,
    "years": 10
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/savings",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "deposit": 1000,
    "monthly": 100,
    "rate": 5,
    "years": 10
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/savings", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"deposit":1000,"monthly":100,"rate":5,"years":10}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"deposit":1000,"monthly":100,"rate":5,"years":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/savings", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "deposit": 1000,
  "monthly": 100,
  "rate": 5,
  "years": 10
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.savings",
  "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 で失敗します。

入力契約、応答の形、誤り時の振る舞い

deposit は単一通貨の開始額です。どちらの流れもゼロにしてよく、同じ契約で純初回預入や純毎月計画を投影できます。rate は名目の年パーセントで、五は年五パーセントを意味し、本当に万分の五を意図するのでなければ小数 0.05 ではありません。rate はゼロから百です。years は地平で、ゼロから八十の有限数です。例：預入千、積立百、五パーセント、十年は months が百二十、月利率は十二分の五パーセントです。検証失敗は残高を消費しません。有限の必須四数を持つ JSON 本体を POST してください。表計算が慣れた列名を保てるよう alias の initial、principal、starting_balance、initial_deposit を受け付け、値はゼロ以上一兆以下です。monthly は同じ単位の繰り返し積立で、alias は contribution、monthly_contribution、pmt、monthly_deposit であり、同じくゼロから一兆です。alias の annual_rate、interest_rate、annual_percent は同じ欄を指します。負の利率は rate を名指しして invalid_input で失敗します。これが契約上の誤りであり、課金されません。二点五のような端数年も許され、alias は t、time、period、duration です。years が負なら、years を名指しして invalid_input で失敗します。各欄は JSON の数でも数値文字列でも構いません。

貯金計算機 API が役立つ場面

家計は緊急資金、住宅の頭金、万一の口座が毎月の定額振込と並ぶとき、合算の地平に一つの数が欲しくて貯金計算機を使います。家計の助言者は、負の利率や負の期間を拒む決定的な神託を必要とし、壊れたフォームが成功と見なし得る縮小や空の残高を黙って出してはなりません。後で月初の期首払い年金預入や、毎月ではなく年次の積立が必要になったら、この四欄の貯金契約を引き伸ばすのではなく、それらの恒等式へ切り替えてください。製品チームは同じ契約を導入デモに結び、預入、毎月積立、年パーセント、duration を打った人が、後の本番試験で API が返すのと同じ final_balance を見るようにします。実装は純粋 parse の段階 A なので、成功した呼び出しは毎回、公表された基本料金 $0.002 であり、モデルのトークンも外向きの通信もありません。要求を小さく保ち、試験で丸めた final_balance、total_contributed、interest を固定すれば、表計算、LMS のプラグイン、エッジのワーカー向けに再現可能な貯金額が得られ、自分で表計算サービスを立てる必要はありません。

連携の活用例

製品デモと CI の固定値

銀行アプリと自動試験に、無料ブラウザウィジェットとバイト単位で一致する決定的な final_balance、total_contributed、interest を入れます。

技術的な質問

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

ブラウザの道具は無料です。API の要求は成功一件あたり $0.002 で前払いの KIT 残高を使い、不正な入力は課金されません。

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