ForHosting KIT · 金融・お金

CPIインフレ率計算

Q: この道具は公式CPI系列を取得したり、複数年ギャップを年率化したりしますか？

しません。 両方の指数水準は利用者が渡します。計算は統計機関のデータをダウンロードせず、系列を基準変更せず、複数年ギャップを年率にもしません。

前のCPIと後のCPIを入れると、その間のインフレ率が分かります。指数が100から103になれば、インフレ率は3％です。2つの比率と、物価が上がったか下がったか変わらないかも表示し、ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

前期CPI: 100
比較時点のCPI: 103

結果

インフレ率: 3
比: 1.03
価格変動: inflation

消費者物価指数（CPI）は、統計機関が固定バスケットの財とサービスの価格を要約して公表する代表指標です。2つのCPI公表値を比べることで、アナリスト、報道、家計はその指数水準をインフレ率に変えます。後の指数から先の指数を引き、先の指数で割り、百を掛けます。このCPIインフレ率計算は2つの指数値を受け取り、その恒等式を適用し、変化率に加えて後の値を先の値で割った比と、インフレ・デフレ・変化なしのラベルを返します。公式系列の取得、季節調整、複数年ギャップの年率化、指数を通じた金額換算は行いません。

CPIインフレの意味と変化率の定義

消費者物価指数は指数の数値であり、パーセントそのものではありません。統計機関は基準期を百に置き、後のバスケットを再スケールします。百二十という公表は、測ったバスケットが基準期より二十パーセント高いことを意味します。

だから生のCPI水準が2つあれば、その2つの日付のあいだのインフレ率を復元できます。後の指数から先の指数を引き、先の指数で割り、百を掛けます。同じ恒等式が教科書の変化率であり、入門マクロ経済学の授業でも、CPI公表の対から前年比インフレを引用する記者会見でも使われます。

後の公表が先より上ならインフレ、下ならデフレ、同じならこの尺度では価格は動いていません。先の指数は分母なので、厳密に正でなければなりません。先のCPIが零なら除算は無限大へ向かい、負なら変化の経済的符号が逆転します。

この計算は Infinity や NaN、作り物の率を返す代わりに、その両方を拒否します。後の指数は先より上でも等しくても下でもよく、零も含みます。測ったバスケットの崩壊は百パーセントの本物のデフレだからです。

この道具は複数年ギャップを年率化せず、系列を別の系列へ基準変更せず、統計機関から公式数字を取得しません。発表、教科書の問題、表計算からすでにお持ちの2つの数の上で閉じた式を評価します。

活用例

前年比CPIのブリーフィング

統計発表の公式な消費者物価指数2点を、報道や調査デスクが引用できる見出しのインフレ率に変えます。

授業と宿題の答え合わせ

先の CPI が零または負なら Infinity を出さず拒否する、再現可能な変化率の模範解答を生成します。

賃金・家賃・生計費の点検

生計費条項、家賃見直し、賃金調整が実測価格に対して書かれているとき、前期の CPI と今期の CPI を比べます。

よくある質問

先のCPIが零または負だとどうなりますか？

分母が零または負だと変化率は未定義、または経済的符号が逆転するため、その依頼は課金されません。

この道具は公式CPI系列を取得したり、複数年ギャップを年率化したりしますか？

しません。両方の指数水準は利用者が渡します。計算は統計機関のデータをダウンロードせず、系列を基準変更せず、複数年ギャップを年率にもしません。

2つのCPIからインフレ率はどう計算しますか？

後の指数から前の指数を引き、前の指数で割って100を掛けます。指数が100から103になった場合、インフレ率は3％になります。

CPIが103というのはどういう意味ですか？

CPIは指数であり、パーセントではありません。統計機関が基準期間を100とするので、103は測定対象の品目の組み合わせが基準期間より3％高いことを意味します。

後のCPIが前より低いとどうなりますか？

結果はマイナスになり、デフレと表示されます。2つが同じなら変化なしと表示されます。後の指数は0でもよく、その場合は100％のデフレです。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/fin/cpi-inflation

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

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

curl -X POST https://api.kit.forhosting.com/fin/cpi-inflation \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cpi_earlier":100,"cpi_later":103}'

const res = await fetch("https://api.kit.forhosting.com/fin/cpi-inflation", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "cpi_earlier": 100,
    "cpi_later": 103
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/cpi-inflation",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "cpi_earlier": 100,
    "cpi_later": 103
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/cpi-inflation", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"cpi_earlier":100,"cpi_later":103}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"cpi_earlier":100,"cpi_later":103}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/cpi-inflation", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "cpi_earlier": 100,
  "cpi_later": 103
}

レスポンス例

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

技術的な注記

入力契約、応答の形、誤り時のふるまい

値は零より真に大きい有限数でなければなりません。有限数でなければならず、先の公表より高くても等しくても低くても構いません。検証失敗は残高を消費しません。必須の有限数2つを含む JSON 本体を POST してください。cpi_earlier は先の期の消費者物価指数であり、変化率の分母です。表計算が慣れ親しんだ列名を保てるよう、別名 earlier_cpi、cpi0、base_cpi を受け付けます。cpi_earlier が欠落、空、無限、零、負のいずれかなら、タスクは cpi_earlier を名指しして invalid_input で失敗します。それが契約上の誤りであり、課金されません。cpi_later は後の期の消費者物価指数です。別名 later_cpi、cpi1、current_cpi は同じ欄に対応します。各欄は JSON の数でも数値文字列でも届いてかまいません。成功時、本体は cpi_earlier と cpi_later をエコーし、inflation_rate を六桁まで half-up した変化率として返し、ratio を後を先で割って八桁に丸めた値として返し、率の符号に応じて price_change を inflation、deflation、unchanged のいずれかにし、恒等式を述べ直す formula 文字列を含めます。例：先が 100、後が 103 なら inflation_rate は 3、ratio は 1.03、price_change は inflation です。先が 250、後が 237.5 なら inflation_rate は負の五、price_change は deflation です。

CPIインフレ率計算が役立つ場面

報道、調査デスク、教室は、統計発表が指数水準を2つ出し、問いが何年も先の購買力予測ではなく変化率であるときに CPI インフレ率計算を使います。家計は昨年の CPI と今年の CPI を比べ、家賃条項、賃金見直し、貯蓄残高を実測価格に照らしてどう読むかを見ます。あとで提示レートで何年にもわたって金額をインフレ調整する必要が出たら、この2公表の CPI 契約を無理に伸ばすのではなく、複利成長の恒等式を使ってください。製品チームは同じ契約をブリーフィング用具に結び、公式公表を2つ打ち込んだ記者が、あとでテスト一式が返すのと同じ inflation_rate を見られるようにします。「実装は純粋な parse のティア A なので、成功した呼び出しは毎回、公表の基本料金 $0.002 で、モデルトークンも外向き通信もありません。要求を小さく保ち、丸めた inflation_rate と ratio をテストに固定すれば、統計機関クライアントを自前で立てずに、ワークシート、LMS プラグイン、エッジワーカー向けの再現可能な変化率が得られます。

技術的な質問

2つのCPI値からインフレ率を求めるにはどうしますか。

有限数の cpi_earlier（厳密に正）と cpi_later を送ってください。API は inflation_rate = (cpi_later − cpi_earlier) / cpi_earlier × 100 に加え、後を先で割った比と price_change ラベルを返します。

後のCPIは先のCPIより低くてもよいですか。

はい。後の公表が先より下ならデフレです。inflation_rate は負、price_change は deflation です。同じ公表なら零を返し、price_change は unchanged です。

CPIインフレ率計算の料金はいくらですか。

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

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