Formulas for

US National Debt

Finance1 credit/cellSheets · ExcelSince 1993
=VERVE("nationaldebt", "field", "date")

Track the national debt from a cell. Returns total, public and per-capita debt, auto-refreshing — Sheets or Excel.

It's one of 250+ live sources you reach with a single =VERVE() function — served from APIVerve's production data engine, billed at 1 credit per resolved cell, and refreshed on whatever cadence you set. No API keys to wrangle, no scripts, no exports.

A real example — the input you type, and the values you can pull from it. Click any cell to see the formula behind it.

nationaldebt.xlsxsample data
A2fx=VERVE("nationaldebt", "field", "date")
A
B
C
D
E
1
Date
Total Debt
Total Debt Formatted
Public Debt
Public Debt Formatted
2
2024-02-01
34186489456789.12
$34.19 trillion
26912345678901.23
$26.91 trillion
3
4
click any cell to see its formula1 credit / cell

Live financial model

Drop =VERVE("nationaldebt", "field", "date") into a cell and your model reads the latest number every refresh — no more pasting figures from a browser tab into a stale sheet.

Track a whole watchlist

Fill a column beside your list of tickers or currencies and every row updates together, so a hundred-row watchlist stays current on its own.

Dashboards that don't rot

Point a chart at the cell =VERVE("nationaldebt", "field", "date") feeds and the chart re-draws as the data moves — a finance dashboard that's live instead of a Monday-morning snapshot.

The same function works in both apps — install once, sign in with your key, and type it into any cell.

Google SheetsAdd-on

Install from the Workspace Marketplace, then drop the formula into a cell. Autocomplete suggests the source and its fields.

=VERVE("nationaldebt", "field", "date")
Microsoft ExcelAdd-in

Same source, same arguments, same key — in Excel on desktop, the web, or mobile. Excel namespaces it as VERVE.CALL. Drag to fill a whole column.

=VERVE.CALL("nationaldebt", "field", "date")

Tune the result by adding name=value before the field argument — in any order. Leave one out and its default applies.

  • date

    Optional date in YYYY-MM-DD format for historical lookup. Omit for current data.

    =VERVE("nationaldebt", "date", "2023-06-15")

Add a field name as the last argument to land just that value in the cell.

  • Total Debt
    =VERVE("nationaldebt", "field", "totalDebt")
  • Total Debt Formatted
    =VERVE("nationaldebt", "field", "totalDebtFormatted")
  • Public Debt
    =VERVE("nationaldebt", "field", "publicDebt")
  • Public Debt Formatted
    =VERVE("nationaldebt", "field", "publicDebtFormatted")
  • Intragovernmental DebtPremium
    =VERVE("nationaldebt", "field", "intragovernmentalDebt")
  • Intragovernmental Debt FormattedPremium
    =VERVE("nationaldebt", "field", "intragovernmentalDebtFormatted")
  • Per CapitaPremium
    =VERVE("nationaldebt", "field", "perCapita")
  • Per Capita FormattedPremium
    =VERVE("nationaldebt", "field", "perCapitaFormatted")
  • Population
    =VERVE("nationaldebt", "field", "population")
  • Public Debt Ratio
    =VERVE("nationaldebt", "field", "publicDebtRatio")
  • Per HouseholdPremium
    =VERVE("nationaldebt", "field", "perHousehold")
  • Per Household FormattedPremium
    =VERVE("nationaldebt", "field", "perHouseholdFormatted")

Premium marks data included on paid plans. On the Free plan a marked field is withheld and a marked input is ignored — either way the cell reads #PREMIUM(name) instead of a value, so a gated answer can never be mistaken for a real one. Everything unmarked works on every plan. Compare plans

US National Debt, answered

Everything you need to wire it into a sheet.

How do I pull US National Debt into Google Sheets?
Install the VerveSheets add-on, sign in once with your key, and type =VERVE("nationaldebt", "field", "totalDebt") into any cell. The "field" argument names the value you want back, so the cell resolves to a single number or string you can chart, sort, or feed into another formula.
What data can I pull from US National Debt?
US National Debt returns totalDebt, totalDebtFormatted, publicDebt, publicDebtFormatted and population, plus 1 more — name any one of them as the "field" argument and that value lands in the cell. Leave the field out and the whole record spills into a two-column table instead.
Can I narrow what US National Debt returns?
Yes — US National Debt takes "date" as optional inputs. They go in as "name", value pairs after the required ones, in any order, so =VERVE("nationaldebt", "date", "2023-06-15") shapes the result without changing anything else.
Which US National Debt fields need a paid plan?
intragovernmentalDebt, intragovernmentalDebtFormatted, perCapita and perCapitaFormatted, plus 2 more are included from the Starter plan up. On the Free plan the cell returns #PREMIUM(field) rather than a wrong or empty value, so it's always obvious which one to upgrade for. Every other field works on Free.
Can I fill a whole column of US National Debt at once?
Yes. Reference a range instead of a single cell and one call returns a value for every row, or drag =VERVE("nationaldebt") down like any spreadsheet function.
How many credits does each US National Debt cell cost?
Each resolved cell costs 1 credit. A cell only re-bills when it actually refreshes, so a sheet you aren't touching doesn't keep charging.
Does US National Debt work in Excel as well as Google Sheets?
Yes — same arguments, same key, same fields. Excel namespaces custom functions, so the call is =VERVE.CALL() there and =VERVE() in Google Sheets; nothing else about it changes.
How current is US National Debt?
It draws on Since 1993, served live from APIVerve's production data engine, and cells recalculate on the cadence you choose — every open, hourly, or every 30 minutes.

Put US National Debt in your next spreadsheet. Add the extension, paste the formula, and the cell keeps itself current.

Scaling up?

Volume pricing, custom SLAs, and dedicated support for high-traffic teams.

Contact sales