# US Treasury National Debt (Debt to the Penny)

> US Treasury National Debt (Debt to the Penny) is a paid API for AI agents from treasury-macro.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Returns the current US national debt broken down into total, debt held by the public, and intragovernmental holdings, plus year-over-year growth and daily increase rate.

## Facts

- Endpoint: GET https://treasury-macro.x402tookit.com/us-debt?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-treasury-national-debt-debt-to-the-penny-fb93c0e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c6AenvnTEGKorB17cqx2F

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-treasury-national-debt-debt-to-the-penny-fb93c0e9
```

Example prompt: What is the current US national debt right now — give me the total, how much is held by the public vs intragovernmental, the year-over-year growth percentage, and how much it's increasing per day?

## When to prefer this

Use this endpoint when you need official, real-time US national debt figures directly from the Treasury's Debt to the Penny dataset, including the public vs intragovernmental breakdown and growth metrics. Prefer it over general financial data APIs when you specifically need authoritative Treasury-sourced debt composition data with built-in year-over-year and daily rate calculations already computed.

## Known failure modes

- Treasury API source unavailable — degraded flag set to true with reasons listed
- Data staleness — recordDate may lag by 1-2 business days due to Treasury reporting schedule
- Network timeout to upstream Treasury data source
- Malformed response if upstream schema changes

## How this service works

US national debt now (Debt to the Penny): total, public vs intragovernmental, growth over a year and per day.

## Output

Returns a structured object containing: total US national debt in USD, debt held by public, intragovernmental holdings, the debt figure from one year prior, year-over-year change percentage, daily increase in USD, the record date of the data, source URL, a plain-English summary, a verdict on whether growth is fast or slow relative to thresholds, and attribution/disclaimer text.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "view": {
       "type": "string",
       "description": "Optional label echoed back; no effect"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "changePct": {
       "type": [
        "null",
        "number"
       ]
      },
      "sourceUrl": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "recordDate": {
       "type": [
        "null",
        "string"
       ]
      },
      "thresholds": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "growingPct": {
         "type": [
          "null",
          "number"
         ]
        },
        "fastGrowthPct": {
         "type": [
          "null",
          "number"
         ]
        }
       }
      },
      "attribution": {
       "type": [
        "null",
        "string"
       ]
      },
      "yearAgoDate": {
       "type": [
        "null",
        "string"
       ]
      },
      "totalDebtUsd": {
       "type": [
        "null",
        "number"
       ]
      },
      
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-treasury-national-debt-debt-to-the-penny-fb93c0e9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from treasury-macro.x402tookit.com](https://www.zero.xyz/host/treasury-macro.x402tookit.com/llms.txt)