API reference / Treasury & debt

Treasury & debt

US public debt, average interest rates, and Treasury reporting FX rates.

3 endpoints. Pay per call in USDC via x402 with no account, or get unlimited calls for $99/mo. Every response is shaped { ticker, data, source, as_of }.

GET/api/v1/national-debt$0.01

US national debt to the penny: total public debt outstanding with daily change

The total US public debt outstanding to the penny — the headline national-debt figure — split into debt held by the public and intragovernmental holdings, with the latest value, prior business day, day-over-day change, and recent history. No ticker needed. Updates each business day. Sourced from the US Treasury (FiscalData). Pass `?limit=` for more history (default 30, max 250).

Example request
GET /api/v1/national-debt
Response type (TypeScript)
interface NationalDebtResponse {
  source: string;
  as_of: string;
  series: string;
  unit: string;
  latest: {
    date: string;
    total_public_debt_outstanding: number;
    debt_held_by_public: number;
    intragovernmental_holdings: number;
  };
  prior: {
    date: string;
    total_public_debt_outstanding: number;
    debt_held_by_public: number;
    intragovernmental_holdings: number;
  };
  change: number;
  change_percent: number;
  history: Array<{
    date: string;
    total_public_debt_outstanding: number;
    debt_held_by_public: number;
    intragovernmental_holdings: number;
  }>;
}
Example response (click to expand)
{
  "source": "us_treasury",
  "as_of": "2026-06-03T00:00:00.000Z",
  "series": "debt_to_penny",
  "unit": "usd",
  "latest": {
    "date": "2026-06-03",
    "total_public_debt_outstanding": 39204974715248.65,
    "debt_held_by_public": 31599703500408.55,
    "intragovernmental_holdings": 7605271214840.1
  },
  "prior": {
    "date": "2026-06-02",
    "total_public_debt_outstanding": 39221984586285.3,
    "debt_held_by_public": 31597886394124.88,
    "intragovernmental_holdings": 7624098192160.42
  },
  "change": -17009871036.65,
  "change_percent": -0.0434,
  "history": [
    {
      "date": "2026-06-03",
      "total_public_debt_outstanding": 39204974715248.65,
      "debt_held_by_public": 31599703500408.55,
      "intragovernmental_holdings": 7605271214840.1
    },
    {
      "date": "2026-06-02",
      "total_public_debt_outstanding": 39221984586285.3,
      "debt_held_by_public": 31597886394124.88,
      "intragovernmental_holdings": 7624098192160.42
    },
    {
      "date": "2026-06-01",
      "total_public_debt_outstanding": 39195502287422.08,
      "debt_held_by_public": 31581373375160.92,
      "intragovernmental_holdings": 7614128912261.16
    },
    {
      "date": "2026-05-29",
      "total_public_debt_outstanding": 39207759598302.62,
      "debt_held_by_public": 31515369798622.98,
      "intragovernmental_holdings": 7692389799679.64
    },
    {
      "date": "2026-05-28",
      "total_public_debt_outstanding": 39176301795549.4,
      "debt_held_by_public": 31466045143781.76,
      "intragovernmental_holdings": 7710256651767.64
    },
    {
      "date": "2026-05-27",
      "total_public_debt_outstanding": 39163302863182.1,
      "debt_held_by_public": 31450452898651.64,
      "intragovernmental_holdings": 7712849964530.46
    },
    {
      "date": "2026-05-26",
      "total_public_debt_outstanding": 39171154946667.59,
      "debt_held_by_public": 31447423137771.69,
      "intragovernmental_holdings": 7723731808895.9
    },
    {
      "date": "2026-05-22",
      "total_public_debt_outstanding": 39112192265187.75,
      "debt_held_by_public": 31400817772622.92,
      "intragovernmental_holdings": 7711374492564.83
    },
    {
      "date": "2026-05-21",
      "total_public_debt_outstanding": 39071200457366.45,
      "debt_held_by_public": 31374788661132.13,
      "intragovernmental_holdings": 7696411796234.32
    },
    {
      "date": "2026-05-20",
      "total_public_debt_outstanding": 39049639932662.87,
      "debt_held_by_public": 31358949739922.2,
      "intragovernmental_holdings": 7690690192740.67
    },
    {
      "date": "2026-05-19",
      "total_public_debt_outstanding": 39070752626994.13,
      "debt_held_by_public": 31359065157830.45,
      "intragovernmental_holdings": 7711687469163.68
    },
    {
      "date": "2026-05-18",
      "total_public_debt_outstanding": 39008999901378.68,
      "debt_held_by_public": 31317917051386.19,
      "intragovernmental_holdings": 7691082849992.49
    },
    {
      "date": "2026-05-15",
      "total_public_debt_outstanding": 38997244508055.09,
      "debt_held_by_public": 31315583263208.62,
      "intragovernmental_holdings": 7681661244846.47
    },
    {
      "date": "2026-05-14",
      "total_public_debt_outstanding": 38954466670318.2,
      "debt_held_by_public": 31277752122232.96,
      "intragovernmental_holdings": 7676714548085.24
    },
    {
      "date": "2026-05-13",
      "total_public_debt_outstanding": 38942623681847.68,
      "debt_held_by_public": 31269241615132.64,
      "intragovernmental_holdings": 7673382066715.04
    },
    {
      "date": "2026-05-12",
      "total_public_debt_outstanding": 38968295059805.35,
      "debt_held_by_public": 31268302404373.3,
      "intragovernmental_holdings": 7699992655432.05
    },
    {
      "date": "2026-05-11",
      "total_public_debt_outstanding": 38946800561409.14,
      "debt_held_by_public": 31262108319021.06,
      "intragovernmental_holdings": 7684692242388.08
    },
    {
      "date": "2026-05-08",
      "total_public_debt_outstanding": 38937475342585.8,
      "debt_held_by_public": 31260345834577.53,
      "intragovernmental_holdings": 7677129508008.27
    },
    {
      "date": "2026-05-07",
      "total_public_debt_outstanding": 38931651718802.09,
      "debt_held_by_public": 31262325604447.63,
      "intragovernmental_holdings": 7669326114354.46
    },
    {
      "date": "2026-05-06",
      "total_public_debt_outstanding": 38918837926582.9,
      "debt_held_by_public": 31263383766000.16,
      "intragovernmental_holdings": 7655454160582.74
    },
    {
      "date": "2026-05-05",
      "total_public_debt_outstanding": 38910619550278.1,
      "debt_held_by_public": 31261787439569.55,
      "intragovernmental_holdings": 7648832110708.55
    },
    {
      "date": "2026-05-04",
      "total_public_debt_outstanding": 38905034125404.78,
      "debt_held_by_public": 31274803442683.56,
      "intragovernmental_holdings": 7630230682721.22
    },
    {
      "date": "2026-05-01",
      "total_public_debt_outstanding": 38882147615630.53,
      "debt_held_by_public": 31271957838023.21,
      "intragovernmental_holdings": 7610189777607.32
    },
    {
      "date": "2026-04-30",
      "total_public_debt_outstanding": 38967833861543.11,
      "debt_held_by_public": 31272489865435.88,
      "intragovernmental_holdings": 7695343996107.23
    },
    {
      "date": "2026-04-29",
      "total_public_debt_outstanding": 38952075248701.65,
      "debt_held_by_public": 31264482575337.52,
      "intragovernmental_holdings": 7687592673364.13
    },
    {
      "date": "2026-04-28",
      "total_public_debt_outstanding": 38951791901141.8,
      "debt_held_by_public": 31266604928934.45,
      "intragovernmental_holdings": 7685186972207.35
    },
    {
      "date": "2026-04-27",
      "total_public_debt_outstanding": 38960955558731.97,
      "debt_held_by_public": 31289756388875.06,
      "intragovernmental_holdings": 7671199169856.91
    },
    {
      "date": "2026-04-24"
… (truncated — call the endpoint for the full response)
GET/api/v1/avg-interest-rates$0.01

Average interest rate the US Treasury pays on its debt, by security type

The average interest rate the US Treasury currently pays on its outstanding debt, broken out by security (Treasury Bills, Notes, Bonds, TIPS, FRNs, savings, and the marketable/total aggregates) for the latest reported month, in percent. No ticker needed. A read on the government's cost of borrowing that complements the /treasury-yields curve. Sourced from the US Treasury (FiscalData).

Example request
GET /api/v1/avg-interest-rates
Response type (TypeScript)
interface AvgInterestRatesResponse {
  source: string;
  as_of: string;
  series: string;
  unit: string;
  record_date: string;
  count: number;
  rates: Array<{
    security_type: string;
    security: string;
    avg_interest_rate: number;
  }>;
}
Example response (click to expand)
{
  "source": "us_treasury",
  "as_of": "2026-05-31T00:00:00.000Z",
  "series": "avg_interest_rates",
  "unit": "percent",
  "record_date": "2026-05-31",
  "count": 16,
  "rates": [
    {
      "security_type": "Marketable",
      "security": "Treasury Bills",
      "avg_interest_rate": 3.69
    },
    {
      "security_type": "Marketable",
      "security": "Treasury Notes",
      "avg_interest_rate": 3.248
    },
    {
      "security_type": "Marketable",
      "security": "Treasury Bonds",
      "avg_interest_rate": 3.413
    },
    {
      "security_type": "Marketable",
      "security": "Treasury Inflation-Protected Securities (TIPS)",
      "avg_interest_rate": 1.079
    },
    {
      "security_type": "Marketable",
      "security": "Treasury Floating Rate Notes (FRN)",
      "avg_interest_rate": 3.563
    },
    {
      "security_type": "Marketable",
      "security": "Federal Financing Bank",
      "avg_interest_rate": 2.389
    },
    {
      "security_type": "Marketable",
      "security": "Total Marketable",
      "avg_interest_rate": 3.386
    },
    {
      "security_type": "Non-marketable",
      "security": "Domestic Series",
      "avg_interest_rate": 7.577
    },
    {
      "security_type": "Non-marketable",
      "security": "Special Purpose Vehicle",
      "avg_interest_rate": 2.781
    },
    {
      "security_type": "Non-marketable",
      "security": "State and Local Government Series",
      "avg_interest_rate": 3.324
    },
    {
      "security_type": "Non-marketable",
      "security": "United States Savings Securities",
      "avg_interest_rate": 3.169
    },
    {
      "security_type": "Non-marketable",
      "security": "United States Savings Inflation Securities",
      "avg_interest_rate": 4.383
    },
    {
      "security_type": "Non-marketable",
      "security": "Government Account Series",
      "avg_interest_rate": 3.194
    },
    {
      "security_type": "Non-marketable",
      "security": "Government Account Series Inflation Securities",
      "avg_interest_rate": 1.349
    },
    {
      "security_type": "Non-marketable",
      "security": "Total Non-marketable",
      "avg_interest_rate": 3.201
    },
    {
      "security_type": "Interest-bearing Debt",
      "security": "Total Interest-bearing Debt",
      "avg_interest_rate": 3.353
    }
  ]
}
GET/api/v1/exchange-rates$0.02

Official US Treasury reporting rates of exchange for ~170 currencies

Official US Treasury reporting rates of exchange — government FX reference rates for ~170 currencies, in units of foreign currency per 1 USD, for the latest quarter. Use for accounting-grade and exotic-currency conversion the market /api/v1/forex feed lacks. Filter with `?currency=Euro`. Updated quarterly. From the US Treasury (FiscalData).

Example request
GET /api/v1/exchange-rates
Response type (TypeScript)
interface ExchangeRatesResponse {
  source: string;
  as_of: string;
  series: string;
  note: string;
  record_date: string;
  count: number;
  rates: Array<{
    country: string;
    currency: string;
    country_currency: string;
    exchange_rate: number;
    effective_date: string;
  }>;
}
Example response (click to expand)
{
  "source": "us_treasury",
  "as_of": "2026-03-31T00:00:00.000Z",
  "series": "rates_of_exchange",
  "note": "Official US Treasury reporting rates of exchange — units of foreign currency per 1 USD. Updated quarterly; use for accounting/reference conversion, not live FX (see /api/v1/forex for market rates).",
  "record_date": "2026-03-31",
  "count": 168,
  "rates": [
    {
      "country": "Afghanistan",
      "currency": "Afghani",
      "country_currency": "Afghanistan-Afghani",
      "exchange_rate": 64.77,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Albania",
      "currency": "Lek",
      "country_currency": "Albania-Lek",
      "exchange_rate": 83.3,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Algeria",
      "currency": "Dinar",
      "country_currency": "Algeria-Dinar",
      "exchange_rate": 132.596,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Angola",
      "currency": "Kwanza",
      "country_currency": "Angola-Kwanza",
      "exchange_rate": 912.13,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Antigua & Barbuda",
      "currency": "East Caribbean Dollar",
      "country_currency": "Antigua & Barbuda-East Caribbean Dollar",
      "exchange_rate": 2.7,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Argentina",
      "currency": "Peso",
      "country_currency": "Argentina-Peso",
      "exchange_rate": 1420,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Armenia",
      "currency": "Dram",
      "country_currency": "Armenia-Dram",
      "exchange_rate": 380,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Australia",
      "currency": "Dollar",
      "country_currency": "Australia-Dollar",
      "exchange_rate": 1.453,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Azerbaijan",
      "currency": "Manat",
      "country_currency": "Azerbaijan-Manat",
      "exchange_rate": 1.7,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bahamas",
      "currency": "Dollar",
      "country_currency": "Bahamas-Dollar",
      "exchange_rate": 1,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bahrain",
      "currency": "Dinar",
      "country_currency": "Bahrain-Dinar",
      "exchange_rate": 0.377,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bangladesh",
      "currency": "Taka",
      "country_currency": "Bangladesh-Taka",
      "exchange_rate": 123,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Barbados",
      "currency": "Dollar",
      "country_currency": "Barbados-Dollar",
      "exchange_rate": 2.02,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Belarus",
      "currency": "New Ruble",
      "country_currency": "Belarus-New Ruble",
      "exchange_rate": 2.951,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Belize",
      "currency": "Dollar",
      "country_currency": "Belize-Dollar",
      "exchange_rate": 2,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Benin",
      "currency": "Cfa Franc",
      "country_currency": "Benin-Cfa Franc",
      "exchange_rate": 567,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bermuda",
      "currency": "Dollar",
      "country_currency": "Bermuda-Dollar",
      "exchange_rate": 1,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bolivia",
      "currency": "Boliviano",
      "country_currency": "Bolivia-Boliviano",
      "exchange_rate": 6.86,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Bosnia",
      "currency": "Marka",
      "country_currency": "Bosnia-Marka",
      "exchange_rate": 1.702,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Botswana",
      "currency": "Pula",
      "country_currency": "Botswana-Pula",
      "exchange_rate": 13.021,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Brazil",
      "currency": "Real",
      "country_currency": "Brazil-Real",
      "exchange_rate": 5.254,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Brunei",
      "currency": "Dollar",
      "country_currency": "Brunei-Dollar",
      "exchange_rate": 1.289,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Burkina Faso",
      "currency": "Cfa Franc",
      "country_currency": "Burkina Faso-Cfa Franc",
      "exchange_rate": 567,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Burundi",
      "currency": "Franc",
      "country_currency": "Burundi-Franc",
      "exchange_rate": 3000,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Cambodia",
      "currency": "Riel",
      "country_currency": "Cambodia-Riel",
      "exchange_rate": 3995,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Cameroon",
      "currency": "Cfa Franc",
      "country_currency": "Cameroon-Cfa Franc",
      "exchange_rate": 570.79,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Canada",
      "currency": "Dollar",
      "country_currency": "Canada-Dollar",
      "exchange_rate": 1.393,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Cape Verde",
      "currency": "Escudo",
      "country_currency": "Cape Verde-Escudo",
      "exchange_rate": 95.96,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Cayman Islands",
      "currency": "Dollar",
      "country_currency": "Cayman Islands-Dollar",
      "exchange_rate": 0.82,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Central African Republic",
      "currency": "Cfa Franc",
      "country_currency": "Central African Republic-Cfa Franc",
      "exchange_rate": 570.79,
      "effective_date": "2026-03-31"
    },
    {
      "country": "Chad",
      "currency": "Cfa Franc",
      "country_currency": "Chad-Cfa Franc",
      "exchange
… (truncated — call the endpoint for the full response)