oanor
Sign up free
Marketplace Pricing Features Sign in

API · /debtcomposition-api

US Debt Composition API

healthy 4,838 Subscribers

What the US national debt is actually made of, served from the Treasury's Monthly Statement of the Public Debt. The headline debt-to-the-penny figure is one number; this is the breakdown — how the roughly $39 trillion splits across Treasury Bills, Notes, Bonds, TIPS and Floating-Rate Notes (the marketable, tradable debt) versus the non-marketable debt (the Government Account Series held by federal trust funds, Savings Bonds, and State and Local Government Series). The composition endpoint returns the latest full breakdown by security class, each with its share of the total and its split between debt held by the public and intragovernmental holdings. The marketable endpoint isolates the tradable securities (Bills/Notes/Bonds/TIPS/FRN) with each one's share of marketable debt — the issuance mix that rates traders and the Treasury's quarterly refunding watch. The history endpoint returns one security class's outstanding amount month by month. This is the debt-structure data-cut, distinct from the debt-to-the-penny total, the fiscal-deficit and the yield-curve APIs in the catalogue. Live, updated monthly, no key on the upstream, nothing stored.

#us-debt #treasury #debt-composition #bills-notes-bonds #tips #fiscal #macro #forex
api.oanor.com/debtcomposition-api
Get an API key Try in playground → Contact provider

Machine-readable spec so AI agents can integrate this API.

/api/debtcomposition-api/openapi.json
/api/debtcomposition-api/llms.txt

Discovery: GET /api/index.json lists every API.

API health

healthy
Uptime
100.00%
Server probes · 24h
Avg latency
249 ms
Server probes · 24h
Subscribers
4,838
active
Total calls
0
last 7 days
status Full status page → · 4 probes/24h

Pricing

Pick a tier — billed monthly, cancel anytime.

Free

Free

  • 31,000 calls / month
  • 5 requests / second
  • Hard cap (429 above quota, no overage)
  • 31,000 calls/month
  • 5 req/sec
  • Composition, marketable & history
  • No credit card
Sign in to subscribe

Starter

€5.90 /month

  • 340,000 calls / month
  • 15 requests / second
  • Hard cap (429 above quota, no overage)
  • 340k calls/month
  • 15 req/sec
  • Full monthly history
  • Email support
Sign in to subscribe

Pro

€17.70 /month

  • 1,420,000 calls / month
  • 40 requests / second
  • Hard cap (429 above quota, no overage)
  • 1.42M calls/month
  • 40 req/sec
  • Issuance-mix research
  • Priority support
Sign in to subscribe

Scale

€41.80 /month

  • 5,100,000 calls / month
  • 100 requests / second
  • Hard cap (429 above quota, no overage)
  • 5.1M calls/month
  • 100 req/sec
  • Macro / desk scale
  • Dedicated SLA
Sign in to subscribe

Built by

P
PremiumApi

Related APIs

Other APIs with overlapping tags.

US Treasury Cash (TGA) API

The US federal government's checking account — the Treasury General Account (TGA) at the Federal Reserve — served from the official Daily Treasury Statement. The TGA is where the government's cash sits, and its day-to-day balance is a closely watched market-liquidity gauge: a falling TGA injects cash into the financial system, a rising one drains it. The balance endpoint returns the latest day's opening balance, total deposits, total withdrawals, closing balance and the net change, in millions and billions of dollars. The history endpoint returns the daily closing TGA balance over a window. The flows endpoint returns the latest day's largest cash deposits and withdrawals by category — withheld and corporate taxes coming in, Social Security and debt redemptions going out — so you can see exactly where the money moved. This is the Treasury-cash and fiscal-liquidity data-cut, distinct from the national-debt, fiscal-deficit and yield-curve APIs in the catalogue. Live, updated each business day, no key on the upstream, nothing stored.

api.oanor.com/treasurycash-api

TIPS Real Yields & Breakeven Inflation API

The inflation-adjusted side of the US Treasury yield curve, served from the Treasury's official daily feeds. The realyields endpoint returns the latest TIPS real yield curve — the inflation-protected (real) yield at the 5, 7, 10, 20 and 30-year maturities. The breakeven endpoint returns market-implied inflation: at each maturity it takes the nominal Treasury yield minus the real yield, which is the average annual inflation rate the bond market is pricing in over that horizon, and returns it alongside the nominal and real components. The history endpoint returns the daily time series of the real yield, the nominal yield and the breakeven inflation rate for one maturity over a year. A 10-year breakeven of 2.3 means the market is pricing roughly 2.3% average inflation over the next decade — a core gauge for rates traders, macro funds and inflation hedgers. This is the real-yield and inflation-expectations data-cut — distinct from the nominal yield-curve, the world-government-bond and the central-bank-rate APIs in the catalogue. Live, no key on the upstream, nothing stored.

api.oanor.com/realyields-api

Crypto Treasury API

Live data on the public companies that hold Bitcoin and Ethereum on their balance sheets, from the public CoinGecko feed. Rank every public company by how much of the coin it holds, with current and entry value, average entry price, country and share of total supply; get the aggregate corporate holdings, USD value and market-cap dominance; find a specific holder by name, ticker or country; and compare Bitcoin and Ethereum corporate treasuries side by side. The corporate crypto-treasury layer — distinct from price and exchange feeds: it answers who holds how much, and what they paid. Live, with a short 60-second upstream cache.

api.oanor.com/cryptotreasury-api

Fed SOMA Balance Sheet API

Live data on the Federal Reserve's balance sheet — the System Open Market Account (SOMA) — via the Federal Reserve Bank of New York's public markets API. SOMA is the portfolio of Treasury securities, agency debt and agency MBS the Fed holds, the asset side of the world's most important central-bank balance sheet, the thing that grows in QE and shrinks in QT. Get the latest weekly snapshot — total holdings and the breakdown across bills, notes and bonds, TIPS, FRNs, agency MBS, CMBS and agency debt. Pull the weekly time series back two decades to see every round of quantitative easing and tightening. Read the actual line-item securities the Fed owns — each CUSIP with its security type, maturity, coupon, par value held and share of the issue outstanding. Bucket the Treasury holdings by time to maturity, the profile that drives the pace of runoff. Live, no key, nothing stored. Distinct from money-market reference-rate, FX-rate, central-bank-policy and stock-index APIs — this is the size, composition and maturity of the Fed's actual securities portfolio. Perfect for rates, macro, fixed-income and analytics apps.

api.oanor.com/fedsoma-api

Frequently asked questions

Quick answers about pricing, quotas, and integration.

How do I get an API key for US Debt Composition API?
Sign up for free at oanor.com, generate an API key from the developer dashboard, and call US Debt Composition API with the x-oanor-key header. No credit card needed for the free tier.
What's the rate limit for US Debt Composition API?
Free tier allows 1 request per second. Paid plans scale up to 50 requests per second on the Mega tier. Hard limits return HTTP 429 above the quota — no surprise overage charges.
How much does US Debt Composition API cost?
US Debt Composition API has a free tier with 100 calls / month. Paid plans start at €5.90 / month with higher quotas and faster rate limits.
Can I cancel my subscription anytime?
Yes. Plans are billed monthly and you can cancel anytime from your billing dashboard. No long-term contracts and no cancellation fee.
Is US Debt Composition API GDPR-compliant?
All requests to US Debt Composition API go through our EU-based gateway. Your upstream API key never leaves our server and no personal data is shared with the upstream provider beyond the request you send.

Pick an endpoint from the list on the left to see its details and try it.

Code snippets

Sign up to get an API key, then call any path under your slug.

curl https://api.oanor.com/debtcomposition-api/SOME_PATH \
  -H "x-oanor-key: oanor_test_..."
const res = await fetch("https://api.oanor.com/debtcomposition-api/SOME_PATH", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
const data = await res.json();
$ch = curl_init("https://api.oanor.com/debtcomposition-api/SOME_PATH");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
$response = curl_exec($ch);
import requests
r = requests.get(
    "https://api.oanor.com/debtcomposition-api/SOME_PATH",
    headers={"x-oanor-key": "oanor_test_..."},
)
print(r.json())

Ratings

Sign in to rate.

No reviews yet.

Discussion

Ask questions, share usage tips, get answers from the provider and other developers. Public — anyone can read.

Sign in to start a thread or reply.

Sign in

New thread

/ 4000

📌 Pinned 🔒 Locked

·

· ·

/ 4000

🔒 This thread is locked — no new replies.

  • No threads yet — start the discussion.

Support

Private 1:1 support with the provider — billing questions, integration issues, account problems. Only you and the provider team can see these threads.

Sign in to open a support ticket.

Sign in

Open new ticket

Describe what you need help with. The provider team gets an email and replies on the ticket page.

  • No tickets yet for this API.

Subscription active — calls can start immediately.

Send your first request —

Subscription active — copy a snippet and fire off your first call.