{"uid":"cap_IGIdslrcYpE3S525AdkQ0","slug":"defillama-stablecoin-detail-by-id-afb398ac","name":"DefiLlama Stablecoin Detail by ID","description":"Stablecoin detail by DefiLlama — circulating-supply history and per-chain distribution for one stablecoin by id.","url":"https://defillama.use.x402atlas.com/stablecoin","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"],"type":"string"},"queryParams":{"type":"object","required":["asset"],"properties":{"asset":{"type":"string","pattern":"^[^/?#]+$","maxLength":100,"minLength":1,"description":"DefiLlama stablecoin id (e.g. 1 for Tether)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["queried_at","data"],"properties":{"data":{"type":"object","properties":{"name":{"type":"string"},"symbol":{"type":"string"},"chainBalances":{"type":"object","description":"Circulating-supply history per chain, keyed by chain name"}},"description":"Full stablecoin record relayed verbatim from DefiLlama"},"queried_at":{"type":"string","format":"date-time","description":"Time the upstream was queried"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"name":"Tether","symbol":"USDT","chainBalances":{"Ethereum":{}}},"queried_at":"2026-07-01T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AkZPho5uY7pu7qGL-KJI_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns circulating-supply history and per-chain distribution for a single stablecoin identified by its DefiLlama asset ID.","exampleAgentPrompt":"Can you pull the circulating supply history and per-chain distribution for Tether from DefiLlama — the asset id is 1?","exampleUseCases":[{"title":"USDC supply across blockchains","prompt":"Can you show me how USDC is distributed across different blockchain networks right now? I want to know which chains are holding the most of it — grab the data from DefiLlama using the USDC asset ID."},{"title":"DAI historical circulating supply","prompt":"I'd like to see the full historical circulating supply for DAI over time. Can you pull that from DefiLlama so I can understand how its supply has changed?"},{"title":"Compare stablecoin chain dominance","prompt":"Can you fetch the per-chain breakdown for USDT from DefiLlama? I'm trying to figure out which blockchains are dominant for Tether's supply right now."}],"resultDescription":"Returns a structured object containing the stablecoin's full historical circulating supply time series and a breakdown of current supply distributed across each blockchain network it operates on.","failureModes":["Invalid or unknown asset ID returns an error or empty response","Missing required 'asset' query parameter results in a 400 bad request","DefiLlama upstream API outage causes 502 or timeout","Non-numeric or malformed asset ID may return a 404 or error body"],"whenToPreferThis":"Use this endpoint when you need detailed, per-chain supply distribution or historical circulating supply data for a specific stablecoin by its DefiLlama asset ID. Prefer it over the aggregate stablecoins list endpoint when you need granular single-asset data rather than a summary across all stablecoins.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:35:43.610Z","isFirstParty":false}