ForHosting KIT · Developer Utilities

Output Gap Calculator

The output gap measures how far an economy's actual production is above or below its estimated sustainable capacity.

● BetaFree · in your browser
Use it from WebAPIEmailTelegramApp soon

This calculator compares actual GDP with potential GDP for the same period and expresses the difference as a percentage of potential GDP. A positive result indicates an inflationary gap, while a negative result indicates a recessionary gap. It also returns the difference in the monetary units supplied, making the calculation easy to audit. Use GDP figures that share the same currency, price basis, seasonal treatment, geography, and period.

Choose actual and potential GDP figures that are genuinely comparable

Enter actual GDP and potential GDP for the same economy and exactly the same period. Both figures must use the same monetary scale, so values may be in dollars, euros, millions, or billions as long as the scale is identical for both inputs. Their price basis must also match. Real actual GDP should be compared with real potential GDP expressed in the same reference-year prices; mixing nominal GDP with a real potential estimate creates a ratio without a defensible economic meaning. Check whether each series is seasonally adjusted, annualized, quarterly, or annual, and avoid pairing incompatible treatments. Potential GDP is not directly observed. It is an estimate of the production level consistent with sustainable use of labor and capital, and different institutions may publish different estimates for the same date. Record the source and data vintage because revisions to actual GDP, labor-market information, productivity assumptions, or the estimation model can materially change the gap. Actual GDP may be zero in the input domain, although that would represent an extreme scenario. Potential GDP must be positive because it is the denominator of the percentage calculation. The calculator accepts values up to the declared limit and rejects missing, nonnumeric, infinite, negative, or otherwise out-of-range figures with a typed input error.

Understand the percentage formula and returned values

The calculator uses the standard relationship: output gap equals actual GDP minus potential GDP, divided by potential GDP, multiplied by one hundred. Potential GDP is the benchmark, so a two-unit difference does not always imply the same percentage gap; its meaning depends on the size of estimated capacity. If actual GDP is 1,020 and potential GDP is 1,000 in the same units, the level difference is 20 and the output gap is 2 percent. The result object returns both original inputs, the signed gap amount, the signed output gap percentage, and an economic signal derived strictly from the sign. A positive percentage is labeled inflationary, a negative percentage recessionary, and an exact zero at potential. The level difference preserves the monetary scale supplied by the user, while the percentage is scale-independent. Results are normalized to twelve significant digits to keep deterministic browser and API output stable. This numeric formatting does not add accuracy to the underlying estimates. Because potential GDP is model-based and routinely revised, reporting many decimal places can suggest more certainty than the evidence supports. For analysis or publication, round the displayed result to a precision appropriate for the source data and retain the unrounded calculation for reproducibility.

Interpret the sign as a macroeconomic indicator, not a complete diagnosis

A positive output gap means measured production exceeds estimated potential output. Economists often call this an inflationary gap because unusually intense use of labor and capital can create wage, price, and supply pressures. A negative output gap means production is below estimated capacity and is commonly called a recessionary gap, suggesting slack resources and weaker demand. A zero result means the two supplied estimates are equal; it does not prove that every market is balanced. These labels describe a conventional macroeconomic interpretation, not a forecast or a policy recommendation. Inflation can rise during a negative gap because of supply shocks, exchange-rate changes, taxes, expectations, or measurement error. Likewise, a positive estimated gap does not guarantee accelerating inflation. Potential GDP itself can shift after productivity changes, labor-force developments, capital destruction, migration, or new information, so yesterday's classification may be revised even when recorded actual GDP barely changes. Central banks, finance ministries, analysts, and students should examine the result alongside inflation measures, employment, capacity utilization, wage growth, financial conditions, and uncertainty bands around potential output. When comparing countries or historical periods, use estimates prepared under compatible methods. For decisions with material consequences, cite the institution, release date, revisions, units, and assumptions behind both GDP series rather than presenting the calculator's category in isolation.

Classify current economic slack

Compare an official actual GDP release with a matching potential GDP estimate to identify the sign and size of the implied gap.

Audit a macroeconomic forecast

Calculate the output gap implied by forecast actual and potential GDP paths and verify the published percentage independently.

Compare scenarios

Measure how alternative demand or productive-capacity assumptions change the level gap and its percentage of potential output.

What formula does the output gap calculator use?

It calculates ((actual GDP - potential GDP) / potential GDP) × 100, which is equivalent to (actual GDP / potential GDP - 1) × 100.

What does a positive output gap mean?

It means actual GDP is above the supplied potential GDP estimate. This is conventionally described as an inflationary gap, though it does not by itself prove that inflation will rise.

What does a negative output gap mean?

It means actual GDP is below the supplied potential GDP estimate. This is conventionally described as a recessionary gap and indicates estimated economic slack.

Can I mix nominal and real GDP?

No. Actual and potential GDP must use the same price basis, currency scale, geography, period, and seasonal treatment for the result to be meaningful.

Why must potential GDP be greater than zero?

Potential GDP is the denominator in the formula. A zero or negative denominator cannot represent a valid positive productive-capacity benchmark for this calculation.

Is potential GDP an observed value?

No. It is a model-based estimate and may differ across institutions or change when historical data and economic assumptions are revised.

What does an API calculation cost?

Each API request costs $0.002. The same deterministic calculation can also run locally in the browser.

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.

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

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.

curl -X POST https://api.kit.forhosting.com/econ/output-gap \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"actual_gdp":1020,"potential_gdp":1000}'
{
  "actual_gdp": 1020,
  "potential_gdp": 1000
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "econ.output_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.

Per request$0.002

Published price — no tokens, no invented credits. A failed task is never charged.

HTTPCodeMeaning
401unauthorizedMissing or invalid API key.
402insufficient_balanceYour balance doesn't cover the task price.
404unknown_typeThat task type doesn't exist.
429rate_limitedToo many requests. Use the webhook instead of polling.

Read the full KIT documentation →