ForHosting KIT · 開発者向けツール

複利計算：将来の元利合計と利息を算出

この複利計算ツールでは、一定の間隔で利息を残高へ組み入れた場合に、当初の元金がどのように増えるかを確認できます。元金、パーセント表示の名目年利率、1年あたりの複利回数、運用年数をご入力ください。計算結果には最終的な元利合計と獲得利息の両方が表示されるため、拠出した資金と運用による増加分を明確に分けられます。同じ決定論的な計算式を、貯蓄予測、投資条件の比較、検証可能な金融例の作成にもご利用いただけます。

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

無料で実行 API仕様を見る

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

4つの入力値を一貫した基準で指定します

まず、利息が付く前の金額である元金をご入力ください。年利率はパーセントで指定するため、5パーセントの場合は小数の 0.05 ではなく 5 と入力します。複利回数は1年間に利息を元金へ組み入れる回数です。1 は年1回、4 は四半期ごと、12 は毎月、365 は毎日を表します。年数には計算対象となる全期間を指定し、1年未満の端数を含めることもできます。このツールは通貨換算を行わないため、元金と結果には同じ通貨単位をご使用ください。元金、年利率、年数にはゼロを指定できますが、複利回数は正の整数でなければなりません。複数の条件を比較する前に、利率の表し方と期間がすべて同じであることをご確認ください。毎月複利の名目年利率を月利として入力する必要はありません。指定された回数に応じて年利率が分割されます。

複利の計算式を理解します

標準的な定期複利の式を使用します。元利合計は、元金に「1と、年利率を複利回数で割った値との和」を掛け、その和を「複利回数と年数の積」で累乗した値です。年利率のパーセント値は、最初に 100 で割って小数へ変換します。獲得利息は、元利合計から当初の元金を引いて求めます。この方法では、利率が一定で、予定された利息の組み入れがすべて行われ、付与された利息が残高に残ると仮定します。追加の入金、引き出し、手数料、税金、利率変更、インフレは考慮しません。他の条件が同じなら、複利回数が多いほど、付与された利息が早く次の利息を生むため、通常は最終額がわずかに増えます。結果は後続計算に役立つ数値精度を保ちつつ、不要な浮動小数点誤差を抑えます。実際の金融判断では、金融機関の規約に従って端数処理をご適用ください。

結果を読み取り、条件を比較します

選択した期間の終了時点における予想残高を確認する場合は、元利合計をご覧ください。当初の元金から増えた部分だけを確認する場合は、獲得利息をご覧ください。口座を適切に比較するには、元金と期間を固定し、一度に1つの条件だけを変更します。複利回数だけを変えると利息組入間隔の影響が分かり、年利率を変えると提示利回りによる、通常はより大きな影響が分かります。この結果は予測であり、保証ではありません。実際の貯蓄商品や投資商品には、変動金利、手数料、最低残高、積立予定、早期引き出し条件、市場リスクなどが存在する場合があります。結果は、表計算シートや監査メモでも再現できる透明な基準値として役立ちます。自動処理では、同じ入力値を1リクエストあたり $0.002 で API に送信できます。商品が名目年利率ではなく実効年利回りを表示している場合は、名目値として入力せず、定義を確認してから比較してください。

活用例

貯蓄残高を予測します

一定の名目年利率で保有する定期預金について、満期時の残高と利息総額を見積もります。

複利回数を比較します

元金、利率、年数を固定し、年1回、四半期、毎月、毎日の複利で増加額がどう変わるかを確認します。

再現可能な金融例を作成します

教材、報告書、表計算の確認、自動計算処理に使用できる決定論的な数値を生成します。

よくある質問

年利率の欄は何を意味しますか？

パーセントで表した名目年利率です。5パーセントなら 0.05 ではなく 5 とご入力ください。

毎月複利の場合、複利回数はいくつですか？

1年間に12回利息を組み入れるため、複利回数を 12 に設定してください。

複利回数を正の値にする必要があるのはなぜですか？

計算式では年利率を複利期間に分割します。ゼロまたは負の期間数には有効な意味がないため、入力エラーになります。

結果には追加の入金や引き出しが含まれますか？

含まれません。1回の元金、一定の利率、追加の資金移動・手数料・税金なしという条件で計算します。

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

API リクエストは1回につき $0.002 です。ブラウザーからも計算できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/calc2/compound-interest

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

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

curl -X POST https://api.kit.forhosting.com/calc2/compound-interest \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"principal":1000,"annual_rate":5,"frequency":12,"years":10}'

const res = await fetch("https://api.kit.forhosting.com/calc2/compound-interest", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "principal": 1000,
    "annual_rate": 5,
    "frequency": 12,
    "years": 10
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/calc2/compound-interest",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "principal": 1000,
    "annual_rate": 5,
    "frequency": 12,
    "years": 10
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/calc2/compound-interest", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"principal":1000,"annual_rate":5,"frequency":12,"years":10}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"principal":1000,"annual_rate":5,"frequency":12,"years":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/calc2/compound-interest", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "principal": 1000,
  "annual_rate": 5,
  "frequency": 12,
  "years": 10
}

レスポンス例

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