{"openapi":"3.1.0","info":{"title":"US Debt Composition API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/debtcomposition-api","description":"oanor gateway"}],"tags":[{"name":"Debt"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/composition":{"get":{"operationId":"get_v1_composition","tags":["Debt"],"summary":"Latest full debt breakdown by security class","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-05-31","count":11,"source":"US Treasury (MSPD)","composition":[{"share_pct":40.66,"amount_busd":15942.7,"amount_musd":15942721.4171,"security_type":"Marketable","security_class":"Notes","held_by_public_busd":15939.4,"intragovernmental_busd":3.3},{"share_pct":20.51,"amount_busd":8039.7,"amount_musd":8039717.26834849,"security_type":"Nonmarketable","security_class":"Government Account Series","held_by_public_busd":366.8,"intragovernmental_busd":7672.9},{"share_pct":17.24,"amount_busd":6758.8,"amount_musd":6758778.5857,"security_type":"Marketable","security_class":"Bills","held_by_public_busd":6758.3,"intragovernmental_busd":0.5},{"share_pct":13.8,"amount_busd":5412.1,"amount_musd":5412096.5247,"security_type":"Marketable","security_class":"Bonds","held_by_public_busd":5401.1,"intragovernmental_busd":11},{"share_pct":5.4,"amount_busd":2118,"amount_musd":2118028.27552178,"security_type":"Marketable","security_class":"TIPS","held_by_public_busd":2117.5,"intragovernmental_busd":0.5},{"share_pct":1.73,"amount_busd":678.3,"amount_musd":678316.5054,"security_type":"Marketable","security_class":"Floating Rate Notes","held_by_public_busd":678.2,"intragovernmental_busd":0.1},{"share_pct":0.38,"amount_busd":148.3,"amount_musd":148275.82870477,"security_type":"Nonmarketable","security_class":"United States Savings Securities","held_by_public_busd":148.3,"intragovernmental_busd":0},{"share_pct":0.23,"amount_busd":89.9,"amount_musd":89868.07291209,"security_type":"Nonmarketable","security_class":"State and Local Government Series","held_by_public_busd":89.9,"intragovernmental_busd":0},{"share_pct":0.03,"amount_busd":10.7,"amount_musd":10707.65250384,"security_type":"Nonmarketable","security_class":"Domestic Series","held_by_public_busd":10.7,"intragovernmental_busd":0},{"share_pct":0.01,"amount_busd":5.2,"amount_musd":5157.34655507,"security_type":"Nonmarketable","security_class":"Other","held_by_public_busd":5.2,"intragovernmental_busd":0},{"share_pct":0.01,"amount_busd":4.1,"amount_musd":4092.6753,"security_type":"Marketable","security_class":"Federal Financing Bank","held_by_public_busd":0,"intragovernmental_busd":4.1}],"marketable_busd":30914,"nonmarketable_busd":8293.7,"total_public_debt_busd":39207.8},"meta":{"timestamp":"2026-06-12T01:41:19.338Z","request_id":"5e5a9e06-18b6-42bd-8d08-fa78b5f23df5"},"status":"ok","message":"Composition retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/history":{"get":{"operationId":"get_v1_history","tags":["Debt"],"summary":"One security class outstanding month by month","description":"","parameters":[{"name":"class","in":"query","required":false,"description":"total, marketable, nonmarketable, bills, notes, bonds, tips, frn, savings, gas","schema":{"type":"string"},"example":"bills"},{"name":"months","in":"query","required":false,"description":"Number of recent months (max 240)","schema":{"type":"string"},"example":"24"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":24,"source":"US Treasury (MSPD)","history":[{"date":"2024-06-30","amount_busd":5765.8,"amount_musd":5765830.0899},{"date":"2024-07-31","amount_busd":5915.8,"amount_musd":5915782.1837},{"date":"2024-08-31","amount_busd":6121.8,"amount_musd":6121801.8453},{"date":"2024-09-30","amount_busd":6004.8,"amount_musd":6004760.6777},{"date":"2024-10-31","amount_busd":6186.8,"amount_musd":6186777.7925},{"date":"2024-11-30","amount_busd":6389.8,"amount_musd":6389763.232},{"date":"2024-12-31","amount_busd":6186.9,"amount_musd":6186882.0707},{"date":"2025-01-31","amount_busd":6379.9,"amount_musd":6379924.9602},{"date":"2025-02-28","amount_busd":6368,"amount_musd":6367951.7093},{"date":"2025-03-31","amount_busd":6156,"amount_musd":6155950.4395},{"date":"2025-04-30","amount_busd":6060,"amount_musd":6060018.6605},{"date":"2025-05-31","amount_busd":6003,"amount_musd":6003024.2416},{"date":"2025-06-30","amount_busd":5784.1,"amount_musd":5784061.0518},{"date":"2025-07-31","amount_busd":5995.9,"amount_musd":5995910.2789},{"date":"2025-08-31","amount_busd":6369,"amount_musd":6369006.639},{"date":"2025-09-30","amount_busd":6397,"amount_musd":6397045.0501},{"date":"2025-10-31","amount_busd":6593.2,"amount_musd":6593194.1855},{"date":"2025-11-30","amount_busd":6723.3,"amount_musd":6723293.4315},{"date":"2025-12-31","amount_busd":6547.3,"amount_musd":6547260.1224},{"date":"2026-01-31","amount_busd":6595.7,"amount_musd":6595659.6707},{"date":"2026-02-28","amount_busd":6808.1,"amount_musd":6808105.8252},{"date":"2026-03-31","amount_busd":6819.6,"amount_musd":6819563.1112},{"date":"2026-04-30","amount_busd":6622,"amount_musd":6621986.4025},{"date":"2026-05-31","amount_busd":6758.8,"amount_musd":6758778.5857}],"security":"Bills"},"meta":{"timestamp":"2026-06-12T01:41:19.687Z","request_id":"9884db5d-c7fc-488a-b793-c40703ed2879"},"status":"ok","message":"History retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/marketable":{"get":{"operationId":"get_v1_marketable","tags":["Debt"],"summary":"Tradable securities (Bills/Notes/Bonds/TIPS/FRN)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"date":"2026-05-31","count":6,"source":"US Treasury (MSPD)","securities":[{"amount_busd":15942.7,"amount_musd":15942721.4171,"security_class":"Notes","share_of_marketable_pct":51.57},{"amount_busd":6758.8,"amount_musd":6758778.5857,"security_class":"Bills","share_of_marketable_pct":21.86},{"amount_busd":5412.1,"amount_musd":5412096.5247,"security_class":"Bonds","share_of_marketable_pct":17.51},{"amount_busd":2118,"amount_musd":2118028.27552178,"security_class":"TIPS","share_of_marketable_pct":6.85},{"amount_busd":678.3,"amount_musd":678316.5054,"security_class":"Floating Rate Notes","share_of_marketable_pct":2.19},{"amount_busd":4.1,"amount_musd":4092.6753,"security_class":"Federal Financing Bank","share_of_marketable_pct":0.01}],"total_marketable_busd":30914},"meta":{"timestamp":"2026-06-12T01:41:19.787Z","request_id":"af84c4eb-351f-43a0-bf85-a473b415c5de"},"status":"ok","message":"Marketable securities retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":31000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":590,"monthly_call_quota":340000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1770,"monthly_call_quota":1420000,"rps_limit":40,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":4180,"monthly_call_quota":5100000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/debtcomposition-api"}