ForHosting KIT · 開発者向けツール

オークンの法則によるGDPギャップ計算

このオークンの法則計算機は、実際の失業率と自然失業率を比較し、現実の経済生産が潜在生産をどの程度上回るか、または下回るかを推定します。両方の率をパーセントで入力し、正のオークン係数を指定するか、一般的な初期値2を使用してください。失業率ギャップをパーセントポイント、推定GDPギャップをパーセントで示し、生産が潜在水準の上・下・同水準のいずれかも明示します。これはシナリオ分析用の簡易ツールであり、予測や各国固有の実証モデルの代替ではありません。

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

無料で実行 API仕様を見る

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

失業率の差をGDPギャップへ換算します

オークンの法則は、労働市場の余剰と経済活動の経験的な関係を表します。この計算機では、失業率ギャップを実際の失業率から自然失業率を引いた値とします。推定GDPギャップは、その差に係数を掛けて符号を反転した値です。式は「GDPギャップ = −β ×（実際の失業率 − 自然失業率）」です。実際の失業率が6.5%、自然失業率が4.5%、βが2なら、差は2ポイントで、推定値は−4%になります。負の符号は、自然率を上回る失業が潜在水準を下回る生産と結び付くことを示します。実際の失業率が自然率より低ければ結果は正となり、両者が等しければゼロです。率は小数比率ではなくパーセント単位で入力します。6.5と入力すれば6.5%を表し、0.065とは入力しません。結果はパーセント、失業率の差はパーセントポイントで表示されます。

オークン係数を慎重に選び、解釈します

係数は、失業率ギャップが一パーセントポイント変わったときに推定GDPギャップがどれだけ反応するかを決めます。係数2は、実際の失業率が自然率を一点上回るごとに、この単純化した関係では生産が潜在水準を約2%下回ることを意味します。初期値は説明に便利ですが、普遍的な値ではありません。推定値は国、期間、データ頻度、定義、統計手法によって異なり、GDPや失業統計の改定でも変化します。本格的な分析では、対象の経済と期間について推定された係数を使い、出典を記録してください。単一の値を過度に精密に示すより、低位・中心・高位の係数で比較する方が有益です。この計算機は通常の負号を内部で適用するため、正の係数だけを受け付けます。方向を変える目的で負の係数を入力すると、経済的な解釈が逆転し、符号を二重に処理することになります。

推定値の用途と限界を理解します

この結果は目安であり、失われた生産を直接測定した値ではありません。潜在生産と自然失業率はいずれも観測できず、推定が必要で、新しいデータや手法によって改定されます。また、構造変化、労働参加の異例な動き、労働時間の変化、生産性ショック、生産と雇用の調整速度が異なる回復局面では、オークンの関係が弱まる場合があります。教育、説明資料、感応度分析、初期的なマクロ経済シナリオにご利用ください。再現と検証ができるよう、入力値と係数を結果と一緒に保存してください。失業率だけを変えれば生産が機械的に変わるという因果関係として扱わないでください。政策や投資判断では、生産関数、設備稼働率、中央銀行の系列、不確実性の幅とも比較する必要があります。APIは$0.002で、同じ決定論的計算をブラウザーでも実行できます。外部データは取得しないため、仮定の品質と基準日は利用者がご確認ください。

活用例

マクロ経済シナリオを作成する

実際の失業率と自然失業率の仮定から、基準・上振れ・下振れケースの透明なGDPギャップを算出できます。

政策資料の計算を確認する

オークンの法則を用いた主張を再計算し、係数と符号の取り決めを明確にできます。

労働市場の余剰を説明する

失業率ギャップが係数によってGDPギャップへどう対応するかを学習者に示せます。

よくある質問

どの計算式を使いますか？

GDPギャップ (%) = −β × [実際の失業率 (%) − 自然失業率 (%)] を使います。βは正のオークン係数です。

失業率が高いと結果が負になるのはなぜですか？

自然率を上回る実際の失業率は労働市場の余剰を示し、通常のオークン関係では潜在水準を下回る生産と関連するためです。

6.5と0.065のどちらで失業率6.5%を入力しますか？

6.5と入力してください。両方の率はパーセント単位で、差はパーセントポイントとして表示されます。

どのオークン係数を使うべきですか？

対象国、期間、モデルに合う推定値をご使用ください。初期値2は説明用であり、普遍的な値ではありません。

これはGDP予測ですか？

いいえ。指定した仮定から相対的なギャップを推定するだけで、データ取得、GDP予測、潜在生産水準の推定は行いません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/econ/okun-law-output-gap

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

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

curl -X POST https://api.kit.forhosting.com/econ/okun-law-output-gap \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"actual_unemployment_percent":6.5,"natural_unemployment_percent":4.5}'

const res = await fetch("https://api.kit.forhosting.com/econ/okun-law-output-gap", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "actual_unemployment_percent": 6.5,
    "natural_unemployment_percent": 4.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/econ/okun-law-output-gap",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "actual_unemployment_percent": 6.5,
    "natural_unemployment_percent": 4.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/econ/okun-law-output-gap", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"actual_unemployment_percent":6.5,"natural_unemployment_percent":4.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"actual_unemployment_percent":6.5,"natural_unemployment_percent":4.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/econ/okun-law-output-gap", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "actual_unemployment_percent": 6.5,
  "natural_unemployment_percent": 4.5
}

レスポンス例

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

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