# Vextorium US National Debt

> Vextorium US National Debt is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Returns current U.S. national debt figures including total debt, public holdings, intragovernmental debt, and 1-year/30-day changes from the U.S. Treasury Fiscal Data.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/us-national-debt?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-us-national-debt-99a043e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iUFvhnlpClJyKTu2JleW8

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 vextorium-us-national-debt-99a043e0 -d '<json body>'
```

Example prompt: What's the current US national debt right now, including how much is held by the public versus intragovernmental, and how much it's changed over the past year and 30 days?

## When to prefer this

Choose this endpoint when you need official, Treasury-sourced US national debt figures with breakdown by public/intragovernmental holdings and change metrics over 30-day and 1-year windows. It is the right choice over general web search when you need structured, machine-readable numeric data with consistent schema. Prefer it over other Vextorium economy endpoints when the specific need is national debt (not interest rates, CPI, or other economic indicators).

## Known failure modes

- No input body required but malformed request structure may return 400 error
- Data may lag by one business day if Treasury hasn't published the latest figure
- Negative 30-day change is valid (debt can temporarily decrease) — not an error
- Service unavailable (503) if upstream Treasury Fiscal Data API is down

## How this service works

Total US public debt outstanding to the penny (held by the public and intragovernmental), with its change over 30 days and one year and the average daily increase. Official US Treasury Fiscal Data.

## Output

A JSON object containing the latest US national debt date, total debt in USD, debt held by the public, intragovernmental debt, 1-year change in USD, 30-day change in USD, daily average increase in USD, a reference date 1 year prior, and the official Treasury data source citation.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "date": {
       "type": [
        "string",
        "null"
       ]
      },
      "source": {
       "type": [
        "string",
        "null"
       ]
      },
      "reference_1y": {
       "type": [
        "string",
        "null"
       ]
      },
      "change_1y_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "change_30d_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "total_debt_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "held_by_public_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "intragovernmental_usd": {
       "type": [
        "number",
        "null"
       ]
      },
      "daily_avg_increase_usd": {
       "type": [
        "number",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-09-30",
  "source": "U.S. Treasury, Debt to the Penny (Fiscal Data, public domain)",
  "reference_1y": "2025-09-30",
  "change_1y_usd": 2534271606405,
  "change_30d_usd": -3815970294,
  "total_debt_usd": 40171825101340,
  "held_by_public_usd": 32425012546391,
  "intragovernmental_usd": 7746812554950,
  "daily_avg_increase_usd": 6943209881
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-us-national-debt-99a043e0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)