{"uid":"cap_WS1Rj73XHIS2dGxEMCdG0","slug":"us-public-debt-outstanding-api-d96525db","name":"US Public Debt Outstanding API","description":"Total US public debt outstanding from the official Treasury Debt to the Penny dataset (FiscalData API, published every business day ~3pm ET). Query: no params -> latest data point; ?limit=30 (1-100, newest first) and ?since=2026-01-01 (record_date floor) for history back to 1993. Returns per day the debt held by the public, intragovernmental holdings and total, in USD. Cached 6h.","url":"https://x402-datashop-production.up.railway.app/v1/us/debt","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":1,"description":"Max records, newest first (1-100)"},"since":{"type":"string","description":"Only records with record_date >= this ISO date"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RZ3Rdj6r_CrbrOTHJkYGL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns official US Treasury total public debt outstanding (debt held by public, intragovernmental holdings, and total) from the FiscalData Debt to the Penny dataset","exampleAgentPrompt":"What's the current US national debt broken down by debt held by the public and intragovernmental holdings? Pull the latest 30 days of data from the official Treasury dataset so I can see the recent trend.","exampleUseCases":null,"resultDescription":"Returns one or more daily records from the Treasury Debt to the Penny dataset, each containing: record_date, debt_held_public_amt (USD), intragov_hold_amt (USD), and tot_pub_debt_out_amt (USD). Results are ordered newest first. The default call returns only the most recent business day's figure; optional params allow up to 100 records and date filtering back to 1993.","failureModes":["limit out of range (1-100): returns error","since date format invalid (non-ISO): returns error","Treasury FiscalData API upstream unavailable: service error","No records matching since date filter (date too recent intraday or weekend): empty result set","Cache serving stale data if Treasury hasn't published yet (~3pm ET on business days)"],"whenToPreferThis":"Use this endpoint when you need official, authoritative US government public debt figures directly from the Treasury's FiscalData Debt to the Penny dataset. Prefer this over general financial data providers when you need the canonical breakdown between debt held by the public and intragovernmental holdings, or when you need historical daily data back to 1993. Best suited for fiscal analysis, macroeconomic research, dashboards tracking national debt trends, or fact-checking debt figures against the official source.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:54:30.530Z","isFirstParty":false}