Spec

Code snippets

curl "https://api.oanor.com/debtcomposition-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/debtcomposition-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/debtcomposition-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/debtcomposition-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "Amounts are millions (musd) and billions (busd) of US dollars. Marketable debt is the tradable securities (Bills, Notes, Bonds, TIPS, FRN); non-marketable is held by trust funds (Government Account Series), savers and governments. history class is total, marketable, nonmarketable, bills, notes, bonds, tips, frn, savings or gas.",
        "source": "US Treasury Monthly Statement of the Public Debt (api.fiscaldata.treasury.gov/debt/mspd, monthly)",
        "service": "debtcomposition-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/history": "One security class's outstanding amount month by month (class=bills, months=24).",
            "GET /v1/marketable": "Tradable securities (Bills/Notes/Bonds/TIPS/FRN) with marketable share.",
            "GET /v1/composition": "Latest full debt breakdown by security class with shares."
        },
        "description": "What the US national debt is made of, from the Treasury's Monthly Statement of the Public Debt. composition returns the latest full breakdown by security class (Bills, Notes, Bonds, TIPS, FRN, Government Account Series, Savings Bonds …) with each one's share; marketable isolates the tradable securities (Bills/Notes/Bonds/TIPS/FRN) with their share of marketable debt; history returns one security class's outstanding amount month by month. Live, no key, nothing stored. The debt-structure data-cut, distinct from the debt-to-the-penny total, fiscal-deficit and yield-curve APIs.",
        "latest_month": "2026-05-31",
        "upstream_status": "ok",
        "total_public_debt_busd": 39207.8
    },
    "meta": {
        "timestamp": "2026-06-12T01:41:19.873Z",
        "request_id": "2e4b2fae-60fb-4b84-aa10-c80f8f9ce0d8"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}