GDP gap calculator
Actual GDP of 10,500 against a potential of 10,000 is a gap of 500, or 5% above potential: an inflationary gap. Enter both levels for the same period to see how far output runs above or below sustainable capacity. Free in your browser.
- Free
- Runs in your browser
- No sign-up
- Your data stays on your device
Run — free
Worked example
- Actual gdp
- 10,500
- Potential gdp
- 10,000
- Gdp gap
- 500
- Gdp gap percent
- 5
- Gap kind
- inflationary
The GDP gap, also called the output gap, is the signed difference between actual GDP and potential GDP for the same period, reported both as a currency amount and as a percent of potential. A positive gap means the economy is running above sustainable capacity and is commonly labeled an inflationary gap; a negative gap means unused labor and capital and is commonly labeled a recessionary gap; a zero gap means output sits at potential. Students, tutors, central-bank watchers, and exam writers need a deterministic identity that never divides by a zero or negative potential level. This GDP gap calculator accepts actual and potential GDP in the same units, returns the amount, the percent, a short kind label, and the formula string.
What the GDP gap measures and how the formula works
The GDP gap, also called the output gap in textbooks and policy notes, is the signed distance between what an economy actually produced in a period and what it could have produced at sustainable full utilization of its labor and capital. Actual GDP is the observed level of output, almost always a real (constant-price) figure so that a change in the price level is not mistaken for a change in volume.
Potential GDP is a counterfactual: the level of output consistent with the natural rate of unemployment, current technology, and the existing capital stock. It is not last year's GDP, not a forecast of next year, and not a hard ceiling—actual output can overshoot potential during a boom and undershoot it in a slump. The amount identity is elementary: GDP gap equals actual GDP minus potential GDP, in whatever currency units you supplied for both levels.
The percent identity scales that amount by potential so economies of different size can be compared: GDP gap percent equals the amount divided by potential GDP, times one hundred. A positive amount and a positive percent mean actual output sits above potential; that configuration is commonly called an inflationary gap because excess demand relative to sustainable capacity tends to raise prices. A negative amount and a negative percent mean unused resources remain; that configuration is a recessionary gap.
When the two levels are equal the gap is zero and the economy is described as sitting at potential. Potential GDP must be strictly greater than zero because the percent form divides by it; a zero or negative potential would make the percent undefined or economically meaningless. This calculator implements that two-number identity only: it does not estimate potential from an HP filter, a production function, or a DSGE model.
You supply one actual level and one potential level in the same units for the same period, and you receive the amount, the percent, and a short kind label ready for problem sets, dashboards, and automated checks.
Where a GDP gap calculator earns its keep
Principles and intermediate macro courses use a GDP gap calculator so students can convert any valid actual and potential pair into the canonical amount and percent without mixing the output gap up with the GDP deflator or with the year-over-year growth rate. Exam generators and LMS plugins need a deterministic oracle that rejects zero or negative potential GDP instead of inventing Infinity or a hollow zero that a buggy grader might treat as at potential.
Policy-watch pages that quote an inflationary or recessionary gap can show the same identity the course uses, including the sign convention that actual minus potential is positive when the economy is overheating. Failed validation does not consume balance. Keep potential strictly positive, pin the rounded amount and percent in tests, and you get reproducible output-gap numbers for homework, LMS plugins, and edge workers without standing up a full national-accounts or production-function pipeline of your own.
Use this capability when you already have both levels; if you have only nominal and real GDP and want a price index, that is the GDP deflator identity and does not belong in this output-gap definition.
What you can do with it
Classroom actual–potential checks
Let students enter actual and potential GDP and verify the gap amount and percent against textbook worked examples, including inflationary and recessionary signs.
LMS and exam auto-grading
Mark output-gap items with a deterministic oracle that rejects zero or negative potential GDP and never invents Infinity for the percent form.
Macro notebooks and policy dashboards
Batch-compute GDP gaps from published actual GDP and an official potential series without spreadsheet formula drift.
FAQ
How is the GDP gap calculated?
GDP gap = actual GDP − potential GDP. GDP gap percent = (actual − potential) / potential × 100. Send both figures in the same units for the same period.
What does a positive GDP gap mean?
A positive gap means actual GDP exceeds potential GDP (inflationary gap). A negative gap means actual sits below potential (recessionary gap). A zero gap means output is at potential.
How is the GDP gap different from the GDP deflator?
The GDP deflator is a price index (nominal / real × 100). The GDP gap is a quantity gap: how far actual output sits from potential, as an amount and as a percent of potential.
What does a negative GDP gap mean?
Actual output is below potential, so labor and capital are sitting unused. This is called a recessionary gap. With actual GDP of 900 and potential of 1,000, the gap is −100, or −10% of potential.
What is potential GDP?
It is the output an economy could sustain with the natural rate of unemployment, current technology and its existing capital. It is not last year's GDP, not a forecast and not a hard ceiling: actual output can overshoot it in a boom.
Related tools
For developers — API access
Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.
API endpoint
Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.
Call it from your stack
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)Example request
{
"actual_gdp": 10500,
"potential_gdp": 10000
}Example response
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.gdp_gap",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.
Pricing
Published price — no tokens, no invented credits. A failed task is never charged.
Errors
| HTTP | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key. |
402 | insufficient_balance | Your balance doesn't cover the task price. |
404 | unknown_type | That task type doesn't exist. |
429 | rate_limited | Too many requests. Use the webhook instead of polling. |
Technical notes
Input contract, response fields, and validation rules
Actual GDP must be a finite number; a zero actual with a positive potential is a large recessionary gap, not a validation error. Missing fields, empty strings, non-finite values, booleans, and a decimals value outside the allowed integer range fail the same way. Keep both figures in the same currency units and the same period so the subtraction is an output gap, not a mixed snapshot. POST a JSON body with two required finite numbers: actual_gdp (observed output) and potential_gdp (sustainable full-utilization output for the same period). Optionally send decimals as an integer from zero through twelve (default six) to control half-up rounding on gdp_gap and gdp_gap_percent. Potential GDP must be strictly greater than zero: zero or negative potential would make the percent form divide by a non-positive denominator, so those requests fail with invalid_input and are not billed. Common aliases are accepted: actual, y, actual_output, or gdp_actual for actual_gdp; potential, ystar, y_star, potential_output, or gdp_potential for potential_gdp. On success the body echoes actual_gdp and potential_gdp, returns gdp_gap as actual minus potential, gdp_gap_percent as that amount over potential times one hundred, gap_kind as a coarse classroom label (inflationary, recessionary, or at_potential), and formula. Example: actual ten thousand five hundred and potential ten thousand yields gdp_gap five hundred, gdp_gap_percent five, and inflationary. Example: actual nine hundred and potential one thousand yields gdp_gap negative one hundred, gdp_gap_percent negative ten, and recessionary. When the two levels match, both figures are zero and gap_kind is at_potential. Pair the numbers with your own multi-year table if you need a time series of gaps; this endpoint computes only the gap for a single actual–potential pair and does not estimate potential, filter noise, or convert between nominal and real GDP.
Where a GDP gap calculator earns its keep
Analyst notebooks and teaching dashboards often recompute textbook tables from published actual GDP and an official potential series; pinning the arithmetic in a tiny parse API keeps spreadsheet drift out of the comparison column.
Technical questions
Why must potential GDP be greater than zero?
The percent form divides by potential GDP. Zero or negative potential makes that percent undefined, so the task fails with invalid_input and is not billed.
What does the GDP gap calculator cost?
The browser tool is free. API requests use prepaid KIT balance at $0.002 per successful call; invalid input is not billed.