{"openapi":"3.1.0","info":{"title":"US Federal Fiscal API","version":"1.0.0","description":"Live US federal fiscal data from the US Treasury's official FiscalData API — the cost-and-flow side of US public finance. Get the federal budget deficit or surplus by month for the current fiscal year (receipts, outlays and the net) from the Monthly Treasury Statement; the interest the United States pays to service its national debt, by month and fiscal-year-to-date, broken down by security type; and the average interest rate the Treasury pays on each class of its debt (Bills, Notes, Bonds, TIPS) plus the weighted overall rate. Live, no key, nothing cached. Distinct from debt-level (debt-to-the-penny) and auction feeds — this is the deficit, the interest bill and the average rate on the debt.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/usfiscal-api","description":"oanor gateway"}],"tags":[{"name":"US Fiscal"}],"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/avg-rates":{"get":{"operationId":"get_v1_avg_rates","tags":["US Fiscal"],"summary":"Average interest rate the Treasury pays on each class of its debt","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Average interest rate (percent) the US Treasury pays on each class of outstanding debt.","rates":[{"security":"Treasury Bills","security_type":"Marketable","avg_interest_rate_pct":3.69},{"security":"Treasury Notes","security_type":"Marketable","avg_interest_rate_pct":3.248},{"security":"Treasury Bonds","security_type":"Marketable","avg_interest_rate_pct":3.413},{"security":"Treasury Inflation-Protected Securities (TIPS)","security_type":"Marketable","avg_interest_rate_pct":1.079},{"security":"Treasury Floating Rate Notes (FRN)","security_type":"Marketable","avg_interest_rate_pct":3.563},{"security":"Federal Financing Bank","security_type":"Marketable","avg_interest_rate_pct":2.389},{"security":"Total Marketable","security_type":"Marketable","avg_interest_rate_pct":3.386},{"security":"Domestic Series","security_type":"Non-marketable","avg_interest_rate_pct":7.577},{"security":"Special Purpose Vehicle","security_type":"Non-marketable","avg_interest_rate_pct":2.781},{"security":"State and Local Government Series","security_type":"Non-marketable","avg_interest_rate_pct":3.324},{"security":"United States Savings Securities","security_type":"Non-marketable","avg_interest_rate_pct":3.169},{"security":"United States Savings Inflation Securities","security_type":"Non-marketable","avg_interest_rate_pct":4.383},{"security":"Government Account Series","security_type":"Non-marketable","avg_interest_rate_pct":3.194},{"security":"Government Account Series Inflation Securities","security_type":"Non-marketable","avg_interest_rate_pct":1.349},{"security":"Total Non-marketable","security_type":"Non-marketable","avg_interest_rate_pct":3.201},{"security":"Total Interest-bearing Debt","security_type":"Interest-bearing Debt","avg_interest_rate_pct":3.353}],"source":"US Treasury avg_interest_rates (FiscalData)","record_date":"2026-05-31","overall_avg_rate_pct":3.353,"marketable_avg_rate_pct":3.386,"non_marketable_avg_rate_pct":3.201},"meta":{"timestamp":"2026-06-10T22:56:35.765Z","request_id":"529d751a-d42b-4850-b862-040dad17fbb6"},"status":"ok","message":"Average rates 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/deficit":{"get":{"operationId":"get_v1_deficit","tags":["US Fiscal"],"summary":"Federal budget deficit/surplus by month (current fiscal year)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Deficit positive = the US spent more than it took in (negative = surplus); USD. FYTD from the Year-to-Date line of the Monthly Treasury Statement.","months":[{"month":"October","deficit":284332743998.37,"outlays":688704092972.07,"receipts":404371348973.7},{"month":"November","deficit":173277175122.92,"outlays":509278895279.9,"receipts":336001720156.98},{"month":"December","deficit":144752110766.43,"outlays":629136126305.68,"receipts":484384015539.25},{"month":"January","deficit":94615162369.21,"outlays":654667062952.38,"receipts":560051900583.17},{"month":"February","deficit":307501433426.17,"outlays":620623118673.01,"receipts":313121685246.84},{"month":"March","deficit":164100313817.86,"outlays":548962915853.65,"receipts":384862602035.79},{"month":"April","deficit":-215024135197.77,"outlays":622318555795.74,"receipts":837342690993.51},{"month":"May","deficit":292648462083.74,"outlays":628160645311.16,"receipts":335512183227.42}],"source":"US Treasury MTS table 1 (FiscalData)","fiscal_year":"2026","record_date":"2026-05-31","fytd_deficit":1246203266386.93,"fytd_outlays":4901851413143.59,"fytd_receipts":3655648146756.66},"meta":{"timestamp":"2026-06-10T22:56:36.125Z","request_id":"211dfb43-2c78-4370-8684-b9091df67f68"},"status":"ok","message":"Deficit 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/interest-expense":{"get":{"operationId":"get_v1_interest_expense","tags":["US Fiscal"],"summary":"Interest paid to service the national debt (month + fiscal-YTD)","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Gross interest expense on the US public debt, in USD. FYTD = fiscal year (starts October) to date.","source":"US Treasury interest_expense (FiscalData)","line_items":[{"type":"Treasury Notes","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":42938102497.28,"fiscal_ytd_expense":324683956226.14},{"type":"Treasury Bills","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":20572050653.66,"fiscal_ytd_expense":167841438866.5},{"type":"Interest Payments","category":"INTEREST EXPENSE ON GOVT ACCOUNT SERIES","month_expense":7198101594.94,"fiscal_ytd_expense":120083596237.4},{"type":"Treasury Bonds","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":15411038428.23,"fiscal_ytd_expense":116421831928.4},{"type":"Int. Expense Inflation Compensation (TIPS)","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":20035565707,"fiscal_ytd_expense":43684557734.14},{"type":"Inflation Compensation","category":"INTEREST EXPENSE ON GOVT ACCOUNT SERIES","month_expense":17896312392.62,"fiscal_ytd_expense":38908799606.8},{"type":"Treasury Floating Rate Notes (FRN)","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":2130296553.83,"fiscal_ytd_expense":17548982350.23},{"type":"Inflation Protected Securities (TIPS)","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":3843582801.03,"fiscal_ytd_expense":17445842219.2},{"type":"Discount Deferred on Redemptions","category":"INTEREST EXPENSE ON GOVT ACCOUNT SERIES","month_expense":774049077.67,"fiscal_ytd_expense":8323054181.45},{"type":"Treasury Notes","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":946762996.01,"fiscal_ytd_expense":7289686903.85},{"type":"Zero Coupon Bonds Amortized Discount","category":"INTEREST EXPENSE ON GOVT ACCOUNT SERIES","month_expense":398167275.65,"fiscal_ytd_expense":2917119081.12},{"type":"Series I","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":305344944.22,"fiscal_ytd_expense":2295492595.61},{"type":"Treasury Bonds","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":251346442.03,"fiscal_ytd_expense":1921678386.49},{"type":"State & Local Government-C/I's, Notes & Bonds","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":244605770.3,"fiscal_ytd_expense":1797636827.96},{"type":"Treasury Inflation Protected Securities (TIPS)","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":162929676.64,"fiscal_ytd_expense":1235671085.33},{"type":"Series E and EE","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":70662615.62,"fiscal_ytd_expense":666414029.52},{"type":"Restoration of Interest","category":"INTEREST EXPENSE ON GOVT ACCOUNT SERIES","month_expense":0,"fiscal_ytd_expense":443612949.17},{"type":"Domestic Series Bonds","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":50155346.48,"fiscal_ytd_expense":384288804.02},{"type":"Treasury Floating Rate Notes (FRN)","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":5613946.63,"fiscal_ytd_expense":45317619.7},{"type":"Domestic Series - C/I's & Demand Deposits","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":990422.1,"fiscal_ytd_expense":15605809.81},{"type":"Premium Paid on Redemptions","category":"INTEREST EXPENSE ON GOVT ACCOUNT SERIES","month_expense":0,"fiscal_ytd_expense":14289349.06},{"type":"Other","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":134701.05,"fiscal_ytd_expense":2321835.69},{"type":"Foreign Series - C/I, Notes & Bonds","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":0,"fiscal_ytd_expense":0},{"type":"REA Series","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":0,"fiscal_ytd_expense":0},{"type":"Matured Debt","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":0,"fiscal_ytd_expense":0},{"type":"Foreign Series Bills","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":0,"fiscal_ytd_expense":0},{"type":"Foreign Series Notes & Bonds","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":0,"fiscal_ytd_expense":0},{"type":"Foreign Series Notes & Bonds","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":0,"fiscal_ytd_expense":0},{"type":"Limited Payability","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":0,"fiscal_ytd_expense":0},{"type":"Recertified Agency Payments","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":0,"fiscal_ytd_expense":0},{"type":"Series H and HH","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":0,"fiscal_ytd_expense":-607.2},{"type":"Discount Collected on Redemptions","category":"INTEREST EXPENSE ON GOVT ACCOUNT SERIES","month_expense":-882520.47,"fiscal_ytd_expense":-17235258.21},{"type":"Treasury Floating Rate Notes (FRN)","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":-4393165.36,"fiscal_ytd_expense":-40700049.25},{"type":"Premium Collected on Issues","category":"INTEREST EXPENSE ON GOVT ACCOUNT SERIES","month_expense":-38882692.56,"fiscal_ytd_expense":-698260303.45},{"type":"Treasury Bonds","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":-112780112.41,"fiscal_ytd_expense":-880050911.66},{"type":"Treasury Notes","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":-139685319.94,"fiscal_ytd_expense":-1095395115.96},{"type":"Accrued Interest Collected on Issues","category":"INTEREST EXPENSE ON GOVT ACCOUNT SERIES","month_expense":-40330368.14,"fiscal_ytd_expense":-1407959310.41},{"type":"Treasury Inflation Protected Securities (TIPS)","category":"INTEREST EXPENSE ON PUBLIC ISSUES","month_expense":-276308230.28,"fiscal_ytd_expense":-2568379857.89}],"record_date":"2026-05-31","total_month_interest":132622551433.83,"total_fiscal_ytd_interest":867263213213.56},"meta":{"timestamp":"2026-06-10T22:56:36.505Z","request_id":"2c4a8af7-982e-4f8d-afff-aea9d26caf56"},"status":"ok","message":"Interest expense 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":["US Fiscal"],"summary":"Service metadata and endpoint list","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"US Treasury FiscalData (api.fiscaldata.treasury.gov, live)","service":"usfiscal-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/deficit":"Federal budget deficit/surplus by month for the current fiscal year (receipts, outlays, net).","GET /v1/avg-rates":"Average interest rate the Treasury pays on each class of its debt, plus the overall rate.","GET /v1/interest-expense":"Interest paid to service the national debt — month and fiscal-YTD, by security type."},"description":"Live US federal fiscal data from the US Treasury's official FiscalData API — the cost-and-flow side of US public finance. The deficit endpoint returns the federal budget deficit/surplus by month for the current fiscal year (receipts, outlays, net) from the Monthly Treasury Statement; the interest-expense endpoint returns the interest the US pays to service its national debt, by month and fiscal-year-to-date, broken down by security type; the avg-rates endpoint returns the average interest rate the Treasury pays on each class of its debt (Bills, Notes, Bonds, TIPS) plus the weighted overall rate. Live, no key, nothing stored. Distinct from debt-level (debt-to-the-penny) and auction feeds — this is the deficit, the interest bill and the average rate on the debt.","upstream_status":"ok","latest_record_date":"2026-05-31"},"meta":{"timestamp":"2026-06-10T22:56:36.853Z","request_id":"48ddef71-5fa9-4c1b-a2a7-8add7d78dc3b"},"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":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":975,"monthly_call_quota":72000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2650,"monthly_call_quota":380000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":6400,"monthly_call_quota":2300000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/usfiscal-api"}