Data provenance · Calculation · Limitations
From Eurostat data to live EU debt estimates.
EU Debt Map separates published facts from modelled movement. This page shows every important step—from the original quarterly observation to the number moving on screen.
- Source
- Eurostat gov_10q_ggdebt
- Coverage
- EU-27 27/27 in the shared period
- Latest reference
- 2026-Q1 Official quarter-end stock
- Last fetched
- 31 Jul 2026 Stored, validated snapshot
01 — The short answer
One official number. One clearly labelled model.
The debt stock and debt-to-GDP ratio come from Eurostat. The live counter does not. EU Debt Map extends the change between the two latest official quarters at a constant pace so the scale and direction remain visible between releases.
Official observation
Published by Eurostat
2026-Q1A dated quarterly stock of consolidated general government gross debt, plus Eurostat’s official percentage-of-GDP series.Modelled estimate
Calculated by EU Debt Map
+€8,204/sA linear continuation of the latest observed quarterly movement. It is an educational display—not an official statistic or forecast.02 — What is being measured
The debt measure is narrower—and more precise—than ‘everything a government owes’.
EU Debt Map uses Maastricht debt: consolidated gross debt at nominal value for the general government sector at the end of each quarter.
Included in Maastricht debt
General government means
- Central government
- State government where applicable
- Local government
- Social security funds
Do not read it as
- Net debt after subtracting government assets
- A complete measure of future pensions or other contingent obligations
- The budget deficit, which is a flow rather than a stock
- A real-time government accounting balance
03 — Source to screen
A reproducible chain, with no live API dependency during normal builds.
The source is remote; the production experience is deliberately stable. New observations are fetched in a controlled update, validated, and written to local snapshots before a deployment can use them.
- 01
Fetch
Request gov_10q_ggdebt for all EU-27 countries in MIO_EUR and PC_GDP.
- 02
Normalize
Map Eurostat’s EL code to GR and convert million-euro values into euros.
- 03
Validate
Reject missing countries, invalid periods and values that disagree with the stored history.
- 04
Preserve
If a country is absent from a valid update, retain its last-known-good official observation.
- 05
Publish
Advance the shared EU-27 period only after all 27 countries are available for that quarter.
Current validated snapshot
- Debt data fetched
- 31 Jul 2026
- Ratio data fetched
- 31 Jul 2026
- Shared-period coverage
- 27/27
- Reference period
- 2026-Q1
04 — The model
The counter converts one quarterly change into a constant per-second pace.
No growth, interest-rate or policy assumption is added. The model only spreads the most recent observed change across time and continues that pace after the latest quarter-end.
Worked example · current German snapshot
2025-Q4 → 2026-Q1- Previous official debt
- €2.84tn
- Latest official debt
- €2.90tn
- Quarterly movement
- +€63.80bn
- Time between anchors
- 90 days
- Modelled pace
- +€8,204/s
How the live debt-to-GDP estimate works
64.4%
Eurostat’s published ratio is the official starting point. The optional live view scales that ratio by the change in the modelled debt total while holding the implied GDP denominator constant.05 — Guardrails
The model is allowed to stop before it is allowed to mislead.
Quarterly data can be delayed, revised or incomplete. Conservative rules keep an unusual source response from becoming a runaway counter.
€50,000/s hard cap
Any calculated country pace is constrained between −€50,000 and +€50,000 per second.
Stale-country freeze
A country more than one shared quarter behind is still shown at its last official value, but its ticker is frozen.
Missing-history fallback
Without two usable observations, movement defaults to zero until a valid comparison exists.
Period consistency
Quarter labels are converted to UTC quarter-end dates before elapsed time is calculated.
Shared EU period
The EU-27 history advances only with complete 27-country coverage, preventing false total comparisons.
No silent substitution
Official debt and official debt-to-GDP remain separate series; a missing ratio is not invented from another source.
06 — Read the estimate responsibly
Precision on screen is not precision in the underlying economy.
The counter is useful for scale, direction and comparison. It cannot reveal what happened on a particular day or predict the next official observation.
Debt does not move smoothly
Governments issue, redeem and revalue debt in discrete transactions. A linear ticker is a visual model.
Euro values can include exchange-rate movement
For non-euro countries, Eurostat converts debt using the exchange rate at the last working day of the quarter.
Official histories can be revised
National authorities and Eurostat may revise earlier quarters after new information, corrections or methodological changes.
Gross debt is not fiscal health
Assets, interest costs, maturity, deficits, growth and currency structure also matter.
Country releases need not arrive together
A country can temporarily retain an older official quarter while newer shared data are incomplete.
The model is not advice
EU Debt Map is an independent educational visualization, not official reporting, forecasting or investment guidance.
07 — Freshness and corrections
Every displayed update should be traceable to a source date and a method version.
Eurostat normally publishes quarterly government debt after national reporting and validation. Revisions can also arrive between regular releases.
Official cadence
Quarterly; Member States transmit data within roughly three months after quarter-end.
Site refresh
A controlled data update, validation and deployment—not an automatic browser-side API request.
Corrections
A corrected official observation replaces the stored value after it passes the same validation checks.
Method record
08 — Audit the method
Original source, exact filters and a citation you can reuse.
The short explanation stays readable; the technical record remains one click away for researchers and developers.
Technical query and pseudocode+
GET /eurostat/api/dissemination/statistics/1.0/data/gov_10q_ggdebt
?lang=EN&format=JSON&freq=Q§or=S13&na_item=GD
&unit=MIO_EUR&lastTimePeriod=20&geo=DE&geo=FR&geo=IT…rate_per_second =
clamp((latest_debt - previous_debt) / seconds_between_dates,
-50000,
+50000)
estimate_now = latest_debt + rate_per_second * seconds_since_latestSuggested citation
EU Debt Map (2026), ‘Methodology: Eurostat data and live government debt estimates’, based on Eurostat gov_10q_ggdebt. Accessed 30 August 2026.Use the original Eurostat source alongside EU Debt Map when reusing the figures.
Continue with the data