ForHosting KIT · 金融・お金

インフレ計算ツール

Q: 利率は負にできますか？

はい。 デフレをモデル化するために可能です。ただし 1 + rate/100 がゼロより上に保たれる限りです。

インフレで金額がどう変わるかが分かります。年3%なら、1000は10年後に1343.92になります。元の金額、将来の金額、年率、年数の4つのうち1つを空けておけば、その値を求めます。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

現在価値: 1,000
率（%）: 3
年数: 10

結果

計算する項目: 将来価値
将来価値: 1,343.92

無料オンライン

1つの式で4つの疑問に答える

インフレも成長も同じ複利の決まりに従います。将来の金額は、元の金額に「1＋年率」を年数の回数だけ掛けたものです。この4つのうち1つを空けておくと、ツールがその値を求めます。将来いくらになるかを知りたいなら、1000に年3%を10年当てはめると1343.92です。目標に届くには今いくら必要かを知りたいなら、掛ける代わりに割ります。2つの金額を結ぶ年率や、変化にかかる年数も同じ式を組み替えて求めるので、どの答えも互いに矛盾しません。

入力するときに気を付けること

年率はパーセントで入力します。3なら年3%の意味で、100で割る計算はツールが行います。年率は毎年同じ値で当てはめるため、将来の見通しを立てる道具であり、過去の公的な物価指数を再現するものではありません。金額は0より大きく、年数は正の値である必要があります。負の年率はデフレを表しますが、マイナス100%を下回ってはいけません。年数を求めるときは、何も変わらないため年率ちょうど0は使えません。結果は選んだ小数点以下の桁数で丸められます。

活用例

購買力

所定のインフレ率で数年後にある金額がいくらの価値になるかを確認します。

利率の逆算

ある金額を一定の年数で別の金額に変えた年率を求めます。

目標到達時間

固定の利率で将来価値に達するのに何年かかるかを計算します。

よくある質問

利率は負にできますか？

はい。デフレをモデル化するために可能です。ただし 1 + rate/100 がゼロより上に保たれる限りです。

年次で複利化しますか？

はい。( 1 + r)^years を適用し、1年あたり1回の複利計算期間として扱います。

どれくらい正確ですか？

decimalsの既定は2で、6まで上げられます。これはrateとyearsのソルバーに役立ちます。

2つの金額の間の年間インフレ率はどう求めますか？

年率を求める項目を選び、元の金額、将来の金額、年数を入力します。2つの金額の比から1年あたりの倍率を求め、年率のパーセントとして返します。

金額が目標に届くまで何年かかりますか？

年数を求める項目を選び、元の金額、目標額、年率を入力します。年数は対数で求めます。年率がちょうど0のときは金額が変わらないため、この計算では受け付けません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/dev/inflation-calculator

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

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

curl -X POST https://api.kit.forhosting.com/dev/inflation-calculator \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"present_value":1000,"rate_percent":3,"years":10}'

const res = await fetch("https://api.kit.forhosting.com/dev/inflation-calculator", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "present_value": 1000,
    "rate_percent": 3,
    "years": 10
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/inflation-calculator",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "present_value": 1000,
    "rate_percent": 3,
    "years": 10
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/inflation-calculator", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"present_value":1000,"rate_percent":3,"years":10}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"present_value":1000,"rate_percent":3,"years":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/inflation-calculator", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "present_value": 1000,
  "rate_percent": 3,
  "years": 10
}

レスポンス例

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

技術的な注記

複利の公式 FV = PV × (1 + r)^years を、他の三つの入力から任意のひとつの未知数 — 将来価値、現在価値、年率、または年数 — について解き、お選びいただいたdecimalsへ決定的に丸めます。

ひとつの公式、四つの未知数

掲載した例では、1000を年率3パーセントで10年育てて1343.92になります。同じエンジンが購買力の目減り — インフレ率を入力して、ある金額が後にいくらの価値になるかを見る — も、必要収益率や目標到達時間の問題も扱います。四つの未知数すべてにわたって計算が対称だからです。dev.inflation_calculatorは、標準的な複利成長の恒等式 FV = PV × (1 + r)^years を適用します。ここでrはrate_percent ÷ 100であり、除外した変数について解くよう式を並べ替えます。solve_forフィールド（既定は "future_value"）が対象を選びます。future_valueはpresent_value、rate、yearsからFVを計算し、present_valueは FV ÷ (1 + r)^years として逆算し、rateは年率の値 (FV ÷ PV)^(1 ÷ years) − 1 をパーセントに戻して返し、yearsは ln(FV ÷ PV) ÷ ln(1 + r) を使います。

各モードが必要とする入力

関与する金額の値はゼロより厳密に大きい有限の数値でなければならず、yearsも同様に正でなければならないため、ゼロや負の期間はべき乗が取られる前に拒否されます。yearsのソルバーはさらに、ちょうどゼロの利率を禁じます。ln(1 + r) がゼロになり、成長時間が定義できなくなるからです。必須の入力はsolve_forによって異なり、そのモードが必要とするフィールドだけが検証されます。future_valueはpresent_value、rate_percent、yearsを必要とし、present_valueはfuture_value、rate_percent、yearsを、rateはpresent_value、future_value、yearsを、yearsはpresent_value、future_value、rate_percentを必要とします。rate_percentはデフレをモデル化するために負になり得ますが、1 + rはゼロより上に保たれなければなりません。認識されないsolve_forの文字列や、有限でない中間結果は、呼び出し側が推測せずに対応できるよう具体的な問題を示す型付きのinvalid_inputエラーを送出します。

精度、丸め、どこで実行するか

成功しなかった呼び出しが前払い残高に課金されることはありません。四つの数値 — present_value、future_value、rate_percent、years — はすべて応答に反映され、それぞれ生の値にhalf-upのゼロから離れる規則で一度だけ丸められます。decimalsは0から6の任意の整数で既定は2、金額だけに必要な精度より高く、余分な一桁二桁が本当に効くrateとyearsのソルバーに役立ちます。

技術的な質問

どの入力が必要ですか？

solve_forの値が要求する三つだけです。残りの一つのフィールドが、計算される値になります。

無料ですか？

ブラウザwidgetでは無料です。APIは1計算あたり$0.002で、成功時にのみ課金されます。

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