ForHosting KIT · 金融・お金

総市場余剰計算機

需要が価格100から1単位ごとに2下がり、供給が20から3ずつ上がる市場では、16単位・価格68で均衡し、総余剰は640になります。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

需要の切片: 100
需要の傾き: 2
供給の切片: 20
供給の傾き: 3

結果

均衡数量: 16
均衡価格: 68
消費者余剰: 256
生産者余剰: 384

総経済余剰は、競争市場における配分的厚生の古典的な尺度です。均衡価格と均衡数量における消費者余剰（買い手が得る純利益）と生産者余剰（売り手が得る純利益）の和です。線形の逆需要 P が a から bQ を引いたもの、線形の逆供給 P が c に dQ を加えたものであるとき、均衡は閉じた形の一点となり、各余剰はその価格に対する直角三角形の面積になります。宿題確認、政策ワークシート、自動採点が三角形の幾何で食い違うことはありません。

線形需要・線形供給と均衡余剰の三角形

教科書のミクロ経済学では、逆需要を価格が需要切片 a から需要傾き b に数量を掛けたものを引いたものとして書き、販売量が増えるほど支払意思が下がる形にします。逆供給は価格が供給切片 c に供給傾き d に数量を掛けたものを加えたものであり、生産が拡大するほど限界費用が上がります。

競争均衡は需要価格と供給価格を等しく置き、均衡数量 Q-star は a から c を引いたものを b と d の和で割ったもの、均衡価格 P-star は a から b に Q-star を掛けたものを引いたもの（同様に c に d に Q-star を掛けたものを加えたもの）に整理されます。

消費者余剰は需要曲線と P-star の水平線のあいだ、数量ゼロから Q-star までの三角形で、二分の一に Q-star に a から P-star を引いたものを掛けます。生産者余剰は供給曲線と同じ価格線のあいだの三角形で、二分の一に Q-star に P-star から c を引いたものを掛けます。

総余剰は両者の和であり、二分の一に Q-star に a から c を引いたものを掛けたものにも等しく、切片間の垂直ギャップ全体に取引量の半分を掛けたものです。この合計は摩擦のないこの市場における配分効率の標準尺度であり、買い手が売り手の費用を上回って評価する単位はすべて取引され、相互に有益な取引は残りません。

切片や傾きが正の数量での交点条件を満たさない場合、意味のある競争均衡余剰は報告できず、計算機は負の数量や空のゼロを作らず入力を拒否します。

総市場余剰が役立つ場面

入門・中級のミクロ経済学では、任意の線形スケジュールについて切片や中点の手計算ミスなく三角形面積を確認するために総市場余剰計算機を使います。LMS や試験ジェネレータには、切片の逆転や傾きゼロを誤りと判定し、欠陥のある採点が成功とみなしかねないゼロ余剰を黙って返さない決定的オラクルが必要です。

政策・コンサルのノートでは、しばしば競争余剰のベースラインを税・補助金・価格規制シナリオと比較します。信頼できる自由市場の総余剰を出発点にすれば、後続の死荷重損失の差分が他ツールにあっても誠実に保てます。検証失敗は残高を消費しません。

活用例

教室での均衡厚生チェック

学生に線形の需要・供給の切片と傾きを入力させ、均衡数量・価格・消費者余剰・生産者余剰・総余剰を教科書の三角形法と照合できるようにします。

LMS・試験の自動採点

非正の傾きや需要切片が供給切片を上回らない場合を拒否し、負の数量を決して作らない決定的オラクルで市場余剰問題を採点します。

DWL ノート向け政策ベースライン

摩擦のない競争的総余剰をベースラインとして計算し、税・下限・上限は別の分析パイプラインで重ねます。

よくある質問

総市場余剰はどのように計算しますか？

逆需要 P=a−bQ と逆供給 P=c+dQ では Q*=(a−c)/(b+d)、P*=a−bQ* です。消費者余剰は (1/2)Q*(a−P*)、生産者余剰は (1/2)Q*(P*−c)、総余剰は CS+PS です。

総市場余剰計算機に必要な入力は何ですか？

任意の decimals（0–12、既定 6）が half-up 丸めを設定します。

なぜ両傾きは正でなければなりませんか？

需要傾きパラメータ b が正だと逆需要は右下がり、供給傾き d が正だと逆供給は右上がりになります。ゼロや負の傾きは、この計算機が実装する標準的な競争市場の幾何を壊します。

需要の切片が供給の切片を上回らないとどうなりますか？

曲線が正の数量で交わらないため、報告すべき競争均衡の余剰がありません。ゼロや負の余剰を本物の結果のように示すのではなく、その入力を受け付けません。

総余剰を手早く求める方法はありますか？

あります。均衡数量の半分に、2つの価格切片の差を掛けます。例では16の半分に100と20の差を掛けて640となり、256と384の合計と一致します。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/econ/total-surplus-market

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

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

curl -X POST https://api.kit.forhosting.com/econ/total-surplus-market \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"demand_intercept":100,"demand_slope":2,"supply_intercept":20,"supply_slope":3}'

const res = await fetch("https://api.kit.forhosting.com/econ/total-surplus-market", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "demand_intercept": 100,
    "demand_slope": 2,
    "supply_intercept": 20,
    "supply_slope": 3
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/econ/total-surplus-market",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "demand_intercept": 100,
    "demand_slope": 2,
    "supply_intercept": 20,
    "supply_slope": 3
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/econ/total-surplus-market", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"demand_intercept":100,"demand_slope":2,"supply_intercept":20,"supply_slope":3}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"demand_intercept":100,"demand_slope":2,"supply_intercept":20,"supply_slope":3}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/econ/total-surplus-market", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "demand_intercept": 100,
  "demand_slope": 2,
  "supply_intercept": 20,
  "supply_slope": 3
}

レスポンス例

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

技術的な注記

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

両傾きは厳密にゼロより大きく、需要が下がり供給が上がる必要があります。需要切片は供給切片より厳密に大きく、曲線が正の数量で交わる必要があります。例として需要切片百、需要傾き二、供給切片二十、供給傾き三では Q-star 十六、P-star 六十八、消費者余剰二百五十六、生産者余剰三百八十四、総余剰六百四十となります。図が必要ならご自身の図と組み合わせてください。POST で JSON 本体に四つの必須の有限数を送ってください。demand_intercept (a)、demand_slope (b)、supply_intercept (c)、supply_slope (d) です。任意で decimals をゼロから十二までの整数（既定は六）として送り、各計算フィールドの half-up 丸めを制御できます。等しいまたは逆転した切片は invalid_input でその規則を示して失敗します。欠落フィールド、空文字、非有限値、許可範囲外の非整数 decimals も invalid_input で失敗し課金されません。成功時は四パラメータを返し、さらに equilibrium_quantity、equilibrium_price、consumer_surplus、producer_surplus、total_surplus（いずれも丸め済み）と、Q-star・P-star・三つの余剰恒等式を述べる formula 文字列を返します。このエンドポイントは厚生の数値のみを返し、グラフや formula 以外の段階的な文章は出しません。

総市場余剰 API が役立つ場面

実装は純粋 parse のティア A のため、成功した各呼び出しはモデルトークンも外向きネットワークもなく公開の基本価格 $0.002 です。リクエストを小さく保ち、丸めた余剰フィールドをテストに固定すれば、宿題・LMS プラグイン・エッジワーカー向けに再現可能な厚生数値を、自前の計算経済学スタックなしで得られます。

技術的な質問

なぜ demand_intercept は supply_intercept より大きくなければなりませんか？

そうでなければ線形曲線は正の数量で交わりません。正の競争均衡がなければ、消費者・生産者余剰の三角形は通常の定義にならず、タスクは invalid_input で失敗します。

総市場余剰計算機の料金はいくらですか？

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

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