{"uid":"cap_LdoVV68OUCz1gcY2f51hE","slug":"x402stock-us-national-debt-outstanding-06afa7ad","name":"x402stock US National Debt Outstanding","description":"The total US public debt outstanding to the penny — the headline national-debt figure — split into debt held by the public and intragovernmental holdings, with the latest value, prior business day, day-over-day change, and recent history. No ticker needed. Updates each business day. Sourced from the US Treasury (FiscalData). Pass `?limit=` for more history (default 30, max 250). From x402stock","url":"https://x402stock.xyz/api/v1/national-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","$schema":"https://json-schema.org/draft/2020-12/schema","required":["limit"],"properties":{"limit":{"type":"integer","default":30,"maximum":250,"exclusiveMinimum":0}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["source","as_of","series","unit","latest","prior","change","change_percent","history"],"properties":{"unit":{"type":"string"},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"prior":{"anyOf":[{"type":"object","required":["date","total_public_debt_outstanding","debt_held_by_public","intragovernmental_holdings"],"properties":{"date":{"type":"string"},"debt_held_by_public":{"anyOf":[{"type":"number"},{"type":"null"}]},"intragovernmental_holdings":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_public_debt_outstanding":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"change":{"anyOf":[{"type":"number"},{"type":"null"}]},"latest":{"anyOf":[{"type":"object","required":["date","total_public_debt_outstanding","debt_held_by_public","intragovernmental_holdings"],"properties":{"date":{"type":"string"},"debt_held_by_public":{"anyOf":[{"type":"number"},{"type":"null"}]},"intragovernmental_holdings":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_public_debt_outstanding":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"series":{"type":"string"},"source":{"type":"string","const":"us_treasury"},"history":{"type":"array","items":{"type":"object","required":["date","total_public_debt_outstanding","debt_held_by_public","intragovernmental_holdings"],"properties":{"date":{"type":"string"},"debt_held_by_public":{"anyOf":[{"type":"number"},{"type":"null"}]},"intragovernmental_holdings":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_public_debt_outstanding":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"unit":"usd","as_of":"2026-06-03T00:00:00.000Z","prior":{"date":"2026-06-02","debt_held_by_public":31597886394124.88,"intragovernmental_holdings":7624098192160.42,"total_public_debt_outstanding":39221984586285.3},"change":-17009871036.65,"latest":{"date":"2026-06-03","debt_held_by_public":31599703500408.55,"intragovernmental_holdings":7605271214840.1,"total_public_debt_outstanding":39204974715248.65},"series":"debt_to_penny","source":"us_treasury","history":[{"date":"2026-06-03","debt_held_by_public":31599703500408.55,"intragovernmental_holdings":7605271214840.1,"total_public_debt_outstanding":39204974715248.65}],"change_percent":-0.0434}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":30}}},"response":{"unit":"usd","as_of":"2026-06-09T00:00:00.000Z","prior":{"date":"2026-06-08","debt_held_by_public":31600133143674.75,"intragovernmental_holdings":7630252571334.34,"total_public_debt_outstanding":39230385715009.09},"change":11337133789.56,"latest":{"date":"2026-06-09","debt_held_by_public":31595464942057.47,"intragovernmental_holdings":7646257906741.19,"total_public_debt_outstanding":39241722848798.66},"series":"debt_to_penny","source":"us_treasury","history":[{"date":"2026-06-09","debt_held_by_public":31595464942057.47,"intragovernmental_holdings":7646257906741.19,"total_public_debt_outstanding":39241722848798.66},{"date":"2026-06-08","debt_held_by_public":31600133143674.75,"intragovernmental_holdings":7630252571334.34,"total_public_debt_outstanding":39230385715009.09},{"date":"2026-06-05","debt_held_by_public":31597881328951.17,"intragovernmental_holdings":7621701058395.54,"total_public_debt_outstanding":39219582387346.71},{"date":"2026-06-04","debt_held_by_public":31610718934247.54,"intragovernmental_holdings":7621431643036.33,"total_public_debt_outstanding":39232150577283.87},{"date":"2026-06-03","debt_held_by_public":31599703500408.55,"intragovernmental_holdings":7605271214840.1,"total_public_debt_outstanding":39204974715248.65},{"date":"2026-06-02","debt_held_by_public":31597886394124.88,"intragovernmental_holdings":7624098192160.42,"total_public_debt_outstanding":39221984586285.3},{"date":"2026-06-01","debt_held_by_public":31581373375160.92,"intragovernmental_holdings":7614128912261.16,"total_public_debt_outstanding":39195502287422.08},{"date":"2026-05-29","debt_held_by_public":31515369798622.98,"intragovernmental_holdings":7692389799679.64,"total_public_debt_outstanding":39207759598302.62},{"date":"2026-05-28","debt_held_by_public":31466045143781.76,"intragovernmental_holdings":7710256651767.64,"total_public_debt_outstanding":39176301795549.4},{"date":"2026-05-27","debt_held_by_public":31450452898651.64,"intragovernmental_holdings":7712849964530.46,"total_public_debt_outstanding":39163302863182.1},{"date":"2026-05-26","debt_held_by_public":31447423137771.69,"intragovernmental_holdings":7723731808895.9,"total_public_debt_outstanding":39171154946667.59},{"date":"2026-05-22","debt_held_by_public":31400817772622.92,"intragovernmental_holdings":7711374492564.83,"total_public_debt_outstanding":39112192265187.75},{"date":"2026-05-21","debt_held_by_public":31374788661132.13,"intragovernmental_holdings":7696411796234.32,"total_public_debt_outstanding":39071200457366.45},{"date":"2026-05-20","debt_held_by_public":31358949739922.2,"intragovernmental_holdings":7690690192740.67,"total_public_debt_outstanding":39049639932662.87},{"date":"2026-05-19","debt_held_by_public":31359065157830.45,"intragovernmental_holdings":7711687469163.68,"total_public_debt_outstanding":39070752626994.13},{"date":"2026-05-18","debt_held_by_public":31317917051386.19,"intragovernmental_holdings":7691082849992.49,"total_public_debt_outstanding":39008999901378.68},{"date":"2026-05-15","debt_held_by_public":31315583263208.62,"intragovernmental_holdings":7681661244846.47,"total_public_debt_outstanding":38997244508055.09},{"date":"2026-05-14","debt_held_by_public":31277752122232.96,"intragovernmental_holdings":7676714548085.24,"total_public_debt_outstanding":38954466670318.2},{"date":"2026-05-13","debt_held_by_public":31269241615132.64,"intragovernmental_holdings":7673382066715.04,"total_public_debt_outstanding":38942623681847.68},{"date":"2026-05-12","debt_held_by_public":31268302404373.3,"intragovernmental_holdings":7699992655432.05,"total_public_debt_outstanding":38968295059805.35},{"date":"2026-05-11","debt_held_by_public":31262108319021.06,"intragovernmental_holdings":7684692242388.08,"total_public_debt_outstanding":38946800561409.14},{"date":"2026-05-08","debt_held_by_public":31260345834577.53,"intragovernmental_holdings":7677129508008.27,"total_public_debt_outstanding":38937475342585.8},{"date":"2026-05-07","debt_held_by_public":31262325604447.63,"intragovernmental_holdings":7669326114354.46,"total_public_debt_outstanding":38931651718802.09},{"date":"2026-05-06","debt_held_by_public":31263383766000.16,"intragovernmental_holdings":7655454160582.74,"total_public_debt_outstanding":38918837926582.9},{"date":"2026-05-05","debt_held_by_public":31261787439569.55,"intragovernmental_holdings":7648832110708.55,"total_public_debt_outstanding":38910619550278.1},{"date":"2026-05-04","debt_held_by_public":31274803442683.56,"intragovernmental_holdings":7630230682721.22,"total_public_debt_outstanding":38905034125404.78},{"date":"2026-05-01","debt_held_by_public":31271957838023.21,"intragovernmental_holdings":7610189777607.32,"total_public_debt_outstanding":38882147615630.53},{"date":"2026-04-30","debt_held_by_public":31272489865435.88,"intragovernmental_holdings":7695343996107.23,"total_public_debt_outstanding":38967833861543.11},{"date":"2026-04-29","debt_held_by_public":31264482575337.52,"intragovernmental_holdings":7687592673364.13,"total_public_debt_outstanding":38952075248701.65},{"date":"2026-04-28","debt_held_by_public":31266604928934.45,"intragovernmental_holdings":7685186972207.35,"total_public_debt_outstanding":38951791901141.8}],"change_percent":0.0289}},"exampleRequest":{"limit":30},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":2,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jdFdsU4h3nT0-z4TPlSuq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current US total public debt outstanding to the penny, split into debt held by the public and intragovernmental holdings, with day-over-day change and recent history sourced from the US Treasury FiscalData.","exampleAgentPrompt":"What is the current US national debt to the penny, including the split between debt held by the public and intragovernmental holdings, and how did it change from the prior business day? Pull the last 60 days of history too.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the source (us_treasury), as-of date, series name, unit, latest business day record (date, total_public_debt_outstanding, debt_held_by_public, intragovernmental_holdings), prior business day record, day-over-day change (absolute and percent), and an array of historical daily records up to the requested limit (default 30, max 250).","failureModes":["limit parameter set to 0 or exceeds 250 — validation error returned","Treasury FiscalData source temporarily unavailable — stale or null data may be returned","Request on a weekend or holiday when no new data has been published — prior business day value returned as latest","Network timeout if upstream Treasury API is slow"],"whenToPreferThis":"Use this endpoint when you need the official, penny-precise US national debt figure directly from the US Treasury FiscalData, including the public vs intragovernmental breakdown and day-over-day change. Prefer it over scraping Treasury websites or using secondary financial data providers when accuracy and authoritative sourcing matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":2,"lastUsedAt":"2026-09-02T02:54:01.469Z","lastSuccessfullyRanAt":"2026-09-02T02:54:01.469Z","lastHealthCheckAt":"2026-09-14T18:47:35.384Z","isFirstParty":false}