Live Debt Clock

Methodology & Sources

This page explains exactly where the numbers on the debt clock come from and how the live-ticking estimate is calculated. We never invent or guess a debt figure — every number traces back to a cited, dated, primary source.

Primary source: Treasury Fiscal Data

The official debt figure is the U.S. Department of the Treasury's Debt to the Penny dataset, published daily (business days) via the public Fiscal Data API. It reports:

  • Total Public Debt Outstanding — debt held by the public plus intragovernmental holdings. This is the figure shown as the “official Treasury total” and used as the anchor for the live estimate.
  • Debt Held by the Public
  • Intragovernmental Holdings

Each record carries a record_date — the date the balance reflects, not the date it was published. We surface that date on every figure derived from it.

Cross-reference: FRED

The Federal Reserve Bank of St. Louis's FRED series GFDEBTN (“Federal Debt: Total Public Debt”) reports the same underlying Treasury debt series on a quarterly cadence and is a useful independent cross-check, though it lags the daily Debt to the Penny data and is not used directly by the clock.

Population, for the per-person figure

The debt-per-person figure divides the live debt estimate by the U.S. resident population from FRED series POPTHM, a monthly population estimate sourced from the Census Bureau and BEA. This is itself an estimate, dated to the month shown next to the figure — treat debt-per-person as illustrative, not precise.

This is a static site — where the fetching happens

This site has no server: it's a static export, published to GitHub Pages. Debt figures are fetched directly by your browser from Treasury's Fiscal Data API when you load the page — Treasury's API allows this (it sends CORS headers permitting cross-origin requests). FRED's public endpoints don't allow direct browser access the same way, so the population figure instead is fetched once per deploy, by the build process itself, and baked into the published site as a dated snapshot.

How the live estimate is calculated

  1. When you load the page, your browser pulls the latest official Total Public Debt Outstanding and its record_date directly from Treasury.
  2. It also pulls the closest available record from approximately 365 days earlier, and computes the average rate of change over that trailing 12-month window: (latest − year_ago) ÷ days_between, in dollars per second. This can be a negative number in periods where debt fell year-over-year.
  3. The displayed number starts at the latest official total and ticks forward using that trailing-12-month rate, updating several times per second. It is re-anchored to a fresh official figure every 5 minutes for as long as the page stays open.

We use a smoothed, trailing-year rate — rather than the single most recent day-over-day change — because daily changes are volatile (driven by bond auction settlements, redemptions, and debt-ceiling mechanics) and can swing sharply in either direction on any given day. That raw single-day change is also shown on the home page, separately labeled, so it isn't hidden.

The live number is therefore always an estimate between official updates, clearly labeled as such, sitting alongside the actual official figure and its as-of date. It is never presented as itself an official Treasury figure.

Update cadence

  • Treasury publishes Debt to the Penny once per business day (no weekend/holiday updates).
  • Debt figures are fetched fresh from Treasury every time the page loads, and re-anchored every 5 minutes while it stays open.
  • Population data (FRED POPTHM) is refreshed once per site deploy — the site rebuilds and redeploys on a schedule (see the deploy workflow in the repo) even with no code changes, so this stays current.

Limitations

  • The live number between Treasury updates is a mathematical projection, not a real-time government feed — no such real-time feed of the exact debt exists.
  • Total Public Debt Outstanding includes intragovernmental holdings (e.g., Social Security trust fund holdings), which some analyses exclude in favor of Debt Held by the Public alone. Both figures are shown where relevant.
  • Population-based per-person figures are approximate and lag the true, unknowable, real-time population.