{"openapi":"3.1.0","info":{"title":"US Treasury Macro","version":"1.0.0","description":"US national debt, the Treasury yield curve with inversion checks, average interest rates on Treasury securities, federal interest expense and Treasury reporting exchange rates, computed from US Treasury open data. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"US Treasury Macro answers one question per call about US government finance and rates: how large is the national debt and how fast is it growing (/us-debt), what do Treasury yields look like and is the curve inverted (/us-yield-curve, /us-yield-spread), what average interest the government pays (/us-avg-interest-rates, /us-interest-expense), and the Treasury's official quarterly exchange rates (/treasury-fx-rate). Each paid GET returns a computed verdict (such as CURVE_INVERTED or DEBT_GROWING_FAST) with the reasons, the source and what was NOT checked. Yields are end-of-day par yields; debt is the daily Debt to the Penny figure. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. Not investment advice. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://treasury-macro.x402tookit.com"}],"paths":{"/treasury-fx-rate":{"get":{"operationId":"treasury_fx_rate","summary":"US Treasury official quarterly reporting exchange rate for a country's currency, with effective date and prior quarters.","description":"US Treasury official quarterly reporting exchange rate for a country's currency, with effective date and prior quarters.","tags":["fx","treasury","reporting-rates"],"parameters":[{"name":"country","in":"query","required":true,"description":"Country or currency fragment, e.g. Canada, Japan, Euro","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"currency":{"type":["null","string"]},"ratePerUsd":{"type":["null","number"]},"effectiveDate":{"type":["null","string"]},"history":{"type":["array","null"],"items":{"type":"object","properties":{"effectiveDate":{"type":["null","string"]},"rate":{"type":["null","number"]}}}},"otherMatches":{"type":["array","null"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"RATE","summary":"Canada-Dollar: 1.418 per US dollar, effective 2026-09-30; previous quarter 1.424.","reasons":["Treasury reporting rates are set quarterly for federal agencies; they are not market rates.","Source: U.S. Department of the Treasury (FiscalData)."],"currency":"Canada-Dollar","ratePerUsd":1.418,"effectiveDate":"2026-09-30","history":[{"effectiveDate":"2026-09-30","rate":1.418},{"effectiveDate":"2026-06-30","rate":1.424}],"otherMatches":[],"attribution":"Source: U.S. Department of the Treasury (FiscalData).","degraded":false,"notChecked":["current market rate (see the FX shelf)"],"source":"US Treasury FiscalData","sourceUrl":"https://fiscaldata.treasury.gov/datasets/treasury-reporting-rates-exchange","asOf":"2026-10-11T03:56:08.112Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/treasury-fx-rate"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/treasury-fx-rate"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/treasury-fx-rate"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/treasury-fx-rate"}}]}}},"/us-avg-interest-rates":{"get":{"operationId":"us_avg_interest_rates","summary":"Average interest rate the US government pays on Treasury bills, notes, bonds and TIPS, with change from a year ago.","description":"Average interest rate the US government pays on Treasury bills, notes, bonds and TIPS, with change from a year ago.","tags":["treasury","interest-rates","fiscal"],"parameters":[{"name":"view","in":"query","required":false,"description":"Optional label echoed back; no effect","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"recordDate":{"type":["null","string"]},"yearAgoDate":{"type":["null","string"]},"securities":{"type":["array","null"],"items":{"type":"object","properties":{"security":{"type":["null","string"]},"ratePct":{"type":["null","number"]},"yearAgoPct":{"type":["null","number"]},"changePoints":{"type":["null","number"]}}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"RATES","summary":"As of 2026-09-30: Treasury Bills 3.87%, Treasury Notes 3.383%, Treasury Bonds 3.466%, Treasury Inflation-Protected Securities (TIPS) 1.149%, Treasury Floating Rate Notes (FRN) 4.141%.","reasons":["Average rate is the weighted average on outstanding securities, which lags market yields because old low-rate debt is still outstanding.","Bills cost more than notes on average: short rates are above long rates."],"recordDate":"2026-09-30","yearAgoDate":"2025-09-30","securities":[{"security":"Treasury Bills","ratePct":3.87,"yearAgoPct":4.187,"changePoints":-0.317},{"security":"Treasury Notes","ratePct":3.383,"yearAgoPct":3.112,"changePoints":0.271}],"attribution":"Source: U.S. Department of the Treasury (FiscalData).","degraded":false,"notChecked":["new-issue yields (see /us-yield-curve)"],"source":"US Treasury FiscalData","sourceUrl":"https://fiscaldata.treasury.gov/datasets/average-interest-rates-treasury-securities","asOf":"2026-10-11T03:56:09.030Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-avg-interest-rates"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-avg-interest-rates"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-avg-interest-rates"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-avg-interest-rates"}}]}}},"/us-debt":{"get":{"operationId":"us_debt","summary":"US national debt now (Debt to the Penny): total, public vs intragovernmental, growth over a year and per day.","description":"US national debt now (Debt to the Penny): total, public vs intragovernmental, growth over a year and per day.","tags":["us-debt","treasury","fiscal"],"parameters":[{"name":"view","in":"query","required":false,"description":"Optional label echoed back; no effect","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"recordDate":{"type":["null","string"]},"totalDebtUsd":{"type":["null","number"]},"heldByPublicUsd":{"type":["null","number"]},"intragovernmentalUsd":{"type":["null","number"]},"yearAgoDate":{"type":["null","string"]},"yearAgoDebtUsd":{"type":["null","number"]},"changePct":{"type":["null","number"]},"increasePerDayUsd":{"type":["null","number"]},"thresholds":{"type":["null","object"],"properties":{"fastGrowthPct":{"type":["null","number"]},"growingPct":{"type":["null","number"]}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"DEBT_GROWING","summary":"US debt $40.305T on 2026-10-08 (public $32.454T, intragovernmental $7.851T); +6.39% over 363 days, about $6.7B a day.","reasons":["Growth is the change in total public debt outstanding between the two record dates.","Source: U.S. Department of the Treasury (FiscalData)."],"recordDate":"2026-10-08","totalDebtUsd":40305316210830,"heldByPublicUsd":32454086117711,"intragovernmentalUsd":7851230093118,"yearAgoDate":"2025-10-10","yearAgoDebtUsd":37885436585425,"changePct":6.39,"increasePerDayUsd":6666335056,"thresholds":{"fastGrowthPct":8,"growingPct":3},"attribution":"Source: U.S. Department of the Treasury (FiscalData).","degraded":false,"notChecked":["debt as a share of GDP (see the World Bank shelf)","unfunded obligations such as Social Security"],"source":"US Treasury FiscalData","sourceUrl":"https://fiscaldata.treasury.gov/datasets/debt-to-the-penny","asOf":"2026-10-11T03:56:09.580Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-debt"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-debt"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-debt"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-debt"}}]}}},"/us-interest-expense":{"get":{"operationId":"us_interest_expense","summary":"US federal interest expense on public debt: latest month, fiscal-year-to-date and split by security type.","description":"US federal interest expense on public debt: latest month, fiscal-year-to-date and split by security type.","tags":["treasury","interest-expense","fiscal"],"parameters":[{"name":"view","in":"query","required":false,"description":"Optional label echoed back; no effect","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"recordDate":{"type":["null","string"]},"monthUsd":{"type":["null","number"]},"fiscalYearToDateUsd":{"type":["null","number"]},"bySecurityType":{"type":["array","null"],"items":{"type":"object","properties":{"type":{"type":["null","string"]},"monthUsd":{"type":["null","number"]},"fiscalYearToDateUsd":{"type":["null","number"]}}}},"thresholds":{"type":["null","object"],"properties":{"largeMonthUsd":{"type":["null","number"]},"veryLargeMonthUsd":{"type":["null","number"]}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"INTEREST_BILL_LARGE","summary":"Interest on public issues, month ending 2026-09-30: $63.1B; fiscal year to date $800B (annualized pace about $757B).","reasons":["Accrued interest expense on marketable and nonmarketable securities held by the public; excludes interest paid to government trust funds.","Source: U.S. Department of the Treasury (FiscalData)."],"recordDate":"2026-09-30","monthUsd":63088126292,"fiscalYearToDateUsd":799980767632,"bySecurityType":[{"type":"Treasury Notes","monthUsd":43512954842,"fiscalYearToDateUsd":498310354191},{"type":"Treasury Bonds","monthUsd":15342104708,"fiscalYearToDateUsd":178218840796}],"thresholds":{"largeMonthUsd":50000000000,"veryLargeMonthUsd":100000000000},"attribution":"Source: U.S. Department of the Treasury (FiscalData).","degraded":false,"notChecked":["interest on intragovernmental holdings","net interest in the federal budget (different definition)"],"source":"US Treasury FiscalData","sourceUrl":"https://fiscaldata.treasury.gov/datasets/interest-expense-on-the-public-debt-outstanding","asOf":"2026-10-11T03:56:10.086Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-interest-expense"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-interest-expense"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-interest-expense"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-interest-expense"}}]}}},"/us-yield-curve":{"get":{"operationId":"us_yield_curve","summary":"Latest US Treasury yield curve from 1 month to 30 years, with 2s10s and 3m10y spreads and an inverted/flat/normal verdict.","description":"Latest US Treasury yield curve from 1 month to 30 years, with 2s10s and 3m10y spreads and an inverted/flat/normal verdict.","tags":["yield-curve","treasury","recession-signal"],"parameters":[{"name":"view","in":"query","required":false,"description":"Optional label echoed back; no effect","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"date":{"type":["null","string"]},"yields":{"type":["null","object"],"properties":{"1M":{"type":["null","number"]},"2M":{"type":["null","number"]},"3M":{"type":["null","number"]},"4M":{"type":["null","number"]},"6M":{"type":["null","number"]},"1Y":{"type":["null","number"]},"2Y":{"type":["null","number"]},"3Y":{"type":["null","number"]},"5Y":{"type":["null","number"]},"7Y":{"type":["null","number"]},"10Y":{"type":["null","number"]},"20Y":{"type":["null","number"]},"30Y":{"type":["null","number"]}}},"spread10Y2Y":{"type":["null","number"]},"spread10Y3M":{"type":["null","number"]},"previousDate":{"type":["null","string"]},"changeSincePrevious":{"type":["null","object"],"properties":{"1M":{"type":["null","number"]},"2M":{"type":["null","number"]},"3M":{"type":["null","number"]},"4M":{"type":["null","number"]},"6M":{"type":["null","number"]},"1Y":{"type":["null","number"]},"2Y":{"type":["null","number"]},"3Y":{"type":["null","number"]},"5Y":{"type":["null","number"]},"7Y":{"type":["null","number"]},"10Y":{"type":["null","number"]},"20Y":{"type":["null","number"]},"30Y":{"type":["null","number"]}}},"thresholds":{"type":["null","object"],"properties":{"flatBelowPoints":{"type":["null","number"]}}},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CURVE_NORMAL","summary":"2026-10-09: 3M 4.25%, 2Y 4.8%, 10Y 5.24%, 30Y 5.6%; 10Y-2Y 0.44 points, 10Y-3M 0.99 points: curve normal.","reasons":["An inverted curve (short yields above long) has preceded most US recessions, with long and variable lags; it is a signal, not a forecast.","Source: U.S. Department of the Treasury (FiscalData)."],"date":"2026-10-09","yields":{"1M":4.13,"2M":4.13,"3M":4.25,"4M":4.29,"6M":4.32,"1Y":4.47,"2Y":4.8,"3Y":4.89,"5Y":5.02,"7Y":5.13,"10Y":5.24,"20Y":5.65,"30Y":5.6},"spread10Y2Y":0.44,"spread10Y3M":0.99,"previousDate":"2026-10-08","changeSincePrevious":{"1M":-0.01,"2M":0,"3M":0.02,"4M":0,"6M":0.02,"1Y":0.03,"2Y":0.05,"3Y":0.04,"5Y":0.03,"7Y":0.02,"10Y":0.02,"20Y":0.01,"30Y":0},"thresholds":{"flatBelowPoints":0.25},"attribution":"Source: U.S. Department of the Treasury (FiscalData).","degraded":false,"notChecked":["real yields (inflation-adjusted)","why the curve has this shape"],"source":"US Treasury daily par yield curve","sourceUrl":"https://home.treasury.gov/resource-center/data-chart-center/interest-rates","asOf":"2026-10-11T03:56:10.741Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-yield-curve"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-yield-curve"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-yield-curve"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-yield-curve"}}]}}},"/us-yield-spread":{"get":{"operationId":"us_yield_spread","summary":"Spread between two Treasury maturities (for example 2Y and 10Y) now and over recent days, with inverted/normal verdict.","description":"Spread between two Treasury maturities (for example 2Y and 10Y) now and over recent days, with inverted/normal verdict.","tags":["yield-curve","spread","treasury"],"parameters":[{"name":"short","in":"query","required":true,"description":"Shorter maturity: 1M 2M 3M 4M 6M 1Y 2Y 3Y 5Y 7Y 10Y 20Y 30Y","schema":{"type":"string"}},{"name":"long","in":"query","required":true,"description":"Longer maturity, same list","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"short":{"type":["null","string"]},"long":{"type":["null","string"]},"latest":{"type":["null","object"],"properties":{"date":{"type":["null","string"]},"spread":{"type":["null","number"]},"short":{"type":["null","number"]},"long":{"type":["null","number"]}}},"recent":{"type":["array","null"],"items":{"type":"object","properties":{"date":{"type":["null","string"]},"spread":{"type":["null","number"]},"short":{"type":["null","number"]},"long":{"type":["null","number"]}}}},"invertedDays":{"type":["null","number"]},"attribution":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"NORMAL","summary":"10Y minus 2Y = 0.44 points on 2026-10-09 (2Y 4.8%, 10Y 5.24%); inverted on 0 of the last 7 days shown.","reasons":["Source: U.S. Department of the Treasury (FiscalData)."],"short":"2Y","long":"10Y","latest":{"date":"2026-10-09","spread":0.44,"short":4.8,"long":5.24},"recent":[{"date":"2026-10-01","spread":0.46,"short":4.78,"long":5.24},{"date":"2026-10-02","spread":0.45,"short":4.83,"long":5.28}],"invertedDays":0,"attribution":"Source: U.S. Department of the Treasury (FiscalData).","degraded":false,"notChecked":["longer history","causes"],"source":"US Treasury daily par yield curve","sourceUrl":"https://home.treasury.gov/resource-center/data-chart-center/interest-rates","asOf":"2026-10-11T03:56:11.004Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-yield-spread"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-yield-spread"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-yield-spread"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://treasury-macro.x402tookit.com/us-yield-spread"}}]}}}}}