# US National Debt (Debt to the Penny) API

> US National Debt (Debt to the Penny) API is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns the daily total U.S. national debt (Debt to the Penny) with day-over-day change and optional historical data for up to N days.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/us-debt
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-national-debt-debt-to-the-penny-api-9db151e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_elHsHoRDsaj1eISxgl8nh

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability us-national-debt-debt-to-the-penny-api-9db151e8 -d '<json body>'
```

Example prompt: What's the current total U.S. national debt today, and how much did it change from yesterday? Also pull the last 15 days of daily debt figures so I can see the trend.

## When to prefer this

Use this endpoint when you need authoritative, up-to-date U.S. national debt figures sourced from the official Debt to the Penny series, especially when you want day-over-day change calculations and a rolling history window already pre-computed — avoiding the need to hit Treasury APIs directly or parse raw CSV data.

## Known failure modes

- Treasury source data unavailable or delayed — may return stale or missing date
- Invalid 'days' parameter (non-integer or negative) — likely 400 or default fallback
- Payment not processed (x402 payment required) — 402 response blocking data
- No historical data available for the requested window if days exceeds available records

## How this service works

ECONOMICS: daily total U.S. national debt (Debt to the Penny) with day-over-day change and history (?days=15). Returns JSON.

## Output

A JSON object containing today's total U.S. national debt in dollars (Debt to the Penny), the day-over-day change in dollars, and optionally an array of historical daily debt readings for the requested number of past days.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-national-debt-debt-to-the-penny-api-9db151e8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)