ForHosting KIT · 金融・お金

GDPギャップ計算機

現実GDPが10,500、潜在GDPが10,000なら、ギャップは500で潜在比5%のプラス、つまりインフレギャップです。同じ期間の2つの水準を入れると、生産が供給能力からどれだけ離れているかが分かります。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

実際のGDP: 10,500
潜在GDP: 10,000

結果

GDPギャップ: 500
GDPギャップ (%): 5
ギャップの種類: inflationary

GDPギャップ（需給ギャップ、アウトプットギャップとも呼ばれます）は、同一期間の現実GDPと潜在GDPの符号付き差で、通貨額と潜在比のパーセントの両方で示します。正のギャップは経済が持続可能な供給能力を上回って稼働していることを意味し、インフレギャップと呼ばれます。負のギャップは労働と資本の未利用を意味し、デフレギャップまたはリセッションギャップと呼ばれます。ゼロなら産出は潜在に一致します。学生、チューター、中央銀行ウォッチャー、試験作成者は、ゼロや負の潜在で割らない確定的な恒等式を必要とします。本計算機は同一単位の現実GDPと潜在GDPを受け取り、額、パーセント、短い種別ラベル、数式文字列を返します。

GDPギャップが測るものとその計算式

GDPギャップは、教科書や政策メモでは需給ギャップとも呼ばれ、ある期間に経済が実際に産出した量と、労働と資本を持続可能な完全利用で産出できたはずの量との符号付き距離です。現実GDPは観測された産出水準で、価格変化を数量変化と取り違えないよう、ほぼ常に実質（固定価格）の数字です。

潜在GDPは反実仮想であり、自然失業率、現行技術、既存資本ストックと整合する産出水準です。前年のGDPでも翌年の予測でも硬い天井でもなく、現実の産出は好況で潜在を上回り、不況で下回ることがあります。額の恒等式は単純です。 GDPギャップは現実GDPから潜在GDPを引いたもので、両水準に指定した通貨単位のままです。

パーセントの恒等式はその額を潜在で割って規模の異なる経済を比べられるようにします。GDPギャップパーセントは額を潜在GDPで割り、100を掛けたものです。正の額と正のパーセントは現実産出が潜在を上回ることを意味し、持続可能な供給能力に対する需要超過が物価を押し上げやすいためインフレギャップと呼ばれます。

負の額と負のパーセントは未利用資源が残ることを意味し、リセッションギャップです。両水準が一致するとギャップはゼロで、経済は潜在にあると説明されます。パーセント形は潜在で割るため、潜在GDPは厳密にゼロより大きくなければなりません。

ゼロまたは負の潜在ではパーセントが未定義または経済的に無意味になります。本計算機はその二数の恒等式だけを実装し、HPフィルター、生産関数、DSGEモデルによる潜在の推定は行いません。同一期間・同一単位の現実水準と潜在水準を1組入力すると、課題、ダッシュボード、自動チェック向けの額、パーセント、短い種別ラベルが得られます。

GDPギャップ計算機が役立つ場面

原理・中級マクロの授業では、有効な現実・潜在の組を標準の額とパーセントに変換し、GDPデフレーターや前年比成長率と混同しないようGDPギャップ計算機を使います。インフレギャップやリセッションギャップを引用する政策ウォッチのページは、経済過熱時に現実マイナス潜在が正になる符号規約を含め、授業と同じ恒等式を示せます。検証失敗は残高を消費しません。

潜在を厳密に正に保ち、丸めた額とパーセントをテストに固定すれば、自前の国民経済計算や生産関数パイプラインを立てずに宿題、LMS、エッジワーカー向けに再現可能な需給ギャップが得られます。すでに両水準があるときに本能力を使ってください。名目と実質しかなく価格指数が欲しい場合はGDPデフレーターの恒等式であり、この需給ギャップの定義には属しません。

活用例

教室での現実・潜在チェック

学生に現実GDPと潜在GDPを入力させ、ギャップの額とパーセントを教科書の例題と照合させます。インフレ方向とリセッション方向の符号も含みます。

LMS・試験の自動採点

ゼロや負の潜在GDPを拒否し、パーセント形で Infinity を決して捏造しない確定的オラクルで需給ギャップ問題を採点します。

マクロ用ノートと政策ダッシュボード

公表された現実GDPと公式の潜在系列からGDPギャップを一括計算し、表計算の式ドリフトを避けます。

よくある質問

正のGDPギャップは何を意味しますか？

正のギャップは現実GDPが潜在を上回ること（インフレギャップ）です。負のギャップは現実が潜在を下回ること（リセッションギャップ）です。ゼロなら産出は潜在にあります。

GDPギャップとGDPデフレーターの違いは何ですか？

GDPデフレーターは価格指数（名目 / 実質 × 100）です。GDPギャップは数量ギャップであり、現実産出が潜在からどれだけ離れているかを額と潜在比のパーセントで示します。

GDPギャップはどう計算しますか？

現実GDPから潜在GDPを引いた差が金額のギャップです。その差を潜在GDPで割って100を掛けるとパーセントになります。10,500と10,000なら500、5%です。

GDPギャップがマイナスのときは何を意味しますか？

生産が潜在水準を下回り、労働や資本が使われずに余っている状態で、デフレギャップと呼ばれます。現実GDPが900、潜在GDPが1,000なら、ギャップは−100、潜在比−10%です。

潜在GDPとは何ですか？

自然失業率、現在の技術、今ある資本で無理なく続けられる生産水準です。前年のGDPでも予測値でもなく、絶対的な上限でもありません。好況期には現実の生産が上回ることもあります。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/fin/gdp-gap

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

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

curl -X POST https://api.kit.forhosting.com/fin/gdp-gap \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"actual_gdp":10500,"potential_gdp":10000}'

const res = await fetch("https://api.kit.forhosting.com/fin/gdp-gap", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "actual_gdp": 10500,
    "potential_gdp": 10000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/gdp-gap",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "actual_gdp": 10500,
    "potential_gdp": 10000
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"actual_gdp":10500,"potential_gdp":10000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/gdp-gap", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "actual_gdp": 10500,
  "potential_gdp": 10000
}

レスポンス例

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

技術的な注記

入力契約、応答フィールド、検証ルール

潜在GDPは厳密にゼロより大きくなければなりません。現実GDPは有限数でなければなりません。正の潜在に対するゼロの現実は大きなリセッションギャップであり、検証エラーではありません。一般的な別名が使えます。ギャップの時系列が必要なら独自の複数年表と組み合わせてください。引き算が需給ギャップになるよう、両数字を同一通貨単位・同一期間に保ってください。混在スナップショットにはなりません。必須の有限数2つを含むJSON本文をPOSTしてください。actual_gdp（観測産出）と potential_gdp（同一期間の持続可能な完全利用産出）です。任意で decimals を0から12の整数（既定6）として送り、gdp_gap と gdp_gap_percent の半上げ丸めを制御できます。ゼロまたは負の潜在ではパーセント形が非正の分母で割ることになり、そのような要求は invalid_input で失敗し課金されません。欠落フィールド、空文字列、非有限値、真偽値、許容整数範囲外の decimals も同様に失敗します。actual_gdp には actual、y、actual_output、gdp_actual、potential_gdp には potential、ystar、y_star、potential_output、gdp_potential です。成功時は actual_gdp と potential_gdp をエコーし、現実マイナス潜在の gdp_gap、その額を潜在で割って100倍した gdp_gap_percent、粗い教室ラベル gap_kind（inflationary、recessionary、at_potential）、および formula を返します。例：現実10500・潜在10000なら gdp_gap は500、gdp_gap_percent は5、inflationary です。例：現実900・潜在1000なら gdp_gap はマイナス100、gdp_gap_percent はマイナス10、recessionary です。両水準が一致すると両数字はゼロで gap_kind は at_potential です。本エンドポイントは単一の現実・潜在組のギャップのみを計算し、潜在の推定、ノイズ除去、名目と実質の換算は行いません。

GDPギャップ計算機が役立つ場面

試験生成器とLMSプラグインには、ゼロや負の潜在GDPを拒否し、壊れた採点が at_potential と誤認しうる Infinity や空のゼロを返さない確定的なオラクルが必要です。アナリストのノートブックや教育ダッシュボードは公表された現実GDPと公式の潜在系列から教科書表を再計算することが多く、小さな parse API に算術を固定すると比較列の表計算ドリフトを防げます。実装は純粋 parse の tier A のため、成功した呼び出しはモデルトークンも外向きネットワークもなく公開の基本料金 $0.002 です。

技術的な質問

GDPギャップはどう計算しますか？

GDP gap = actual GDP − potential GDP。GDP gap percent = (actual − potential) / potential × 100。同一期間・同一単位の両方を送ってください。APIは額、パーセント、種別ラベルを返します。

潜在GDPがゼロより大きくなければならない理由は？

パーセント形は潜在GDPで割ります。ゼロまたは負の潜在ではそのパーセントが未定義になるため、タスクは invalid_input で失敗し課金されません。

GDPギャップ計算機の料金は？

ブラウザツールは無料です。APIリクエストは成功した呼び出しごとに前払いKIT残高から $0.002 です。無効入力は課金されません。

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

GDPギャップ計算機

無料で実行

計算例

GDPギャップが測るものとその計算式

GDPギャップ計算機が役立つ場面

活用例

教室での現実・潜在チェック

LMS・試験の自動採点

マクロ用ノートと政策ダッシュボード

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

入力契約、応答フィールド、検証ルール

GDPギャップ計算機が役立つ場面

技術的な質問

ありがとう