Skip to content
Eden Engine

U.S. National Debt Outstanding by Fiscal Year, 1790 to Today

fiscaldata/historical-debt-outstanding

The total U.S. public debt outstanding at the end of each fiscal year, from 1790 to the latest completed year, as one dollar figure per year, taken directly from the U.S. Treasury's Fiscal Data API (Historical Debt Outstanding). Newest year first. Filter to a span of years for a growth series, or take the latest row for the current national debt. The reporting date changed over the centuries, from January 1 in the earliest era to July 1, then June 30, then September 30 from fiscal 1977 onward, and each row carries its own era's date.

activeper callv1

Price

$0.00273 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

U.S. Department of the Treasury (Fiscal Data)

Data from the U.S. Department of the Treasury, Bureau of the Fiscal Service (Fiscal Data, fiscaldata.treasury.gov), offered without restriction per fiscaldata.treasury.gov/api-documentation.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "fiscaldata/historical-debt-outstanding" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "fiscaldata/historical-debt-outstanding" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "fiscaldata/historical-debt-outstanding", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "fiscaldata/historical-debt-outstanding", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.00273
Updated
Oct 19, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "limit"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 10000,
      "minimum": 1,
      "description": "Which page of `limit` rows to return, starting at 1. A page past the last one is an error; meta.total-pages says how many there are."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "How many years to return, newest first, 1 to 1000. The whole series is 238 rows, so 238 returns every year from 1790 and 1 returns the latest."
    },
    "filter": {
      "type": "string",
      "default": "",
      "maxLength": 500,
      "description": "Optional Fiscal Data filter: field:operator:value terms separated by commas, all of which must hold. Fields: record_date (the fiscal year end, YYYY-MM-DD), record_fiscal_year (for example 2026) and debt_outstanding_amt. Operators: eq, lt, lte, gt, gte, in (a parenthesised list). Examples: record_date:gte:2000-09-30 for this century, record_fiscal_year:eq:1945 for one year, and record_fiscal_year:in:(1980,1990,2000,2010,2020) for a decade series. Leave empty for the whole 238-year run. A value that matches nothing returns an empty list; an unknown field or operator is a validation error."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "data",
    "meta"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "record_date",
          "debt_outstanding_amt",
          "record_fiscal_year"
        ],
        "properties": {
          "record_date": {
            "type": "string",
            "description": "The date the figure is as of, YYYY-MM-DD. This is the fiscal year end of that era, not always September 30: January 1 in the earliest years, then July 1, then June 30, then September 30 from fiscal 1977 on."
          },
          "record_fiscal_year": {
            "type": "string",
            "description": "The federal fiscal year the row is for, as a four-digit string."
          },
          "debt_outstanding_amt": {
            "type": "string",
            "description": "Total public debt outstanding in whole dollars and cents, as a decimal string (40171825101340.31 is about 40.17 trillion dollars). Not in millions."
          }
        },
        "additionalProperties": true
      },
      "description": "One row per fiscal year. Empty when nothing matches."
    },
    "meta": {
      "type": "object",
      "required": [
        "count",
        "total-count",
        "total-pages"
      ],
      "properties": {
        "count": {
          "type": "integer",
          "description": "How many rows this page holds."
        },
        "labels": {
          "type": "object",
          "description": "Human-readable name of each column."
        },
        "dataTypes": {
          "type": "object",
          "description": "The Treasury's type name for each column."
        },
        "dataFormats": {
          "type": "object",
          "description": "The Treasury's display format for each column."
        },
        "total-count": {
          "type": "integer",
          "description": "How many rows match the filter in all, across every page."
        },
        "total-pages": {
          "type": "integer",
          "description": "How many pages of `limit` rows the whole match makes."
        }
      },
      "additionalProperties": true
    },
    "links": {
      "type": "object",
      "description": "Treasury's own self, first, prev, next and last page links."
    }
  },
  "description": "The Treasury's response: one row per fiscal year, newest first, and a meta block with the match count.",
  "additionalProperties": true
}