Check Treasury debt data, then make the snapshot repeatable

Know which debt number you are reading

The Treasury's Debt to the Penny dataset separates debt held by the public from intragovernmental holdings. Their sum is total public debt outstanding. A chart, report, or script that labels all three simply “national debt” can obscure which series changed.

The dataset is reported each business day with data for the previous business day. That means a retrieval time and a record date are different. Keep both in any copied table or automated summary, and check the source's update note before treating a missing weekend row as a data error.

Start with a free snapshot

Our free US national debt and Treasury snapshot shows the latest available public figures without requiring an account. Use it to see the field names, source dates, and current response before you wire the same data into a script.

Make a repeatable local record

For a report, scheduled job, or agent workflow, retain the raw value, unit, source URL, record date, and retrieval time. Compare like with like: public debt held by the public should not be silently compared with total public debt outstanding. If you join debt with interest or cash series, check each series' own coverage and update schedule.

1. Run a sample first so the output shape is clear.
2. Fetch the current public data when the job needs freshness.
3. Store the source and date alongside each value.
4. Use JSON output for downstream scripts, and recheck key figures at Fiscal Data before publication.

treasury-watch is a standard-library Python CLI for that local workflow. It includes an offline sample and an optional public Fiscal Data refresh, then prints a readable snapshot or JSON. The sample is for testing, not a claim about today's debt.

For per-call agent access instead of a download, see the paid Treasury snapshot API (x402, USDC on Base). Prefer card billing? Subscribe on RapidAPI for the same snapshot endpoint. The shop lists all current products and prices.