as_of, cache_age_seconds,
freshness_sla_seconds, and stale. Data more than two hours old (its
freshness SLA) is served with stale: true, X-Data-Stale: true and a
Warning header.
Get stablecoin data
GET /v1/stablecoins/data
Query parameters:
type:overview,detail, oryields. Defaultoverview.slug: stablecoin slug. Required whentype=detail.
Metric semantics
- Shares (
marketShare,supplyShare,velocityCoverage,velocityNonEvmShareand thepegStability30dbands), supply changes (supplyChange24h,supplyChange7d,supplyChange30d),pegDeviation,supplyTvlRatioand the yield figures (totalApy,baseApy,rewardApy,totalApyChange7dand theirbest*counterparts on each row) are fractions:0.054is 5.4%, and an APY is per year.totalApyChange7dis the difference of two APYs, not a relative change. nominalSupplyValueis circulating units translated to USD at the asset’s reference peg. The legacymarketCapfield is retained as a compatibility alias, but it is not live marked market capitalization.circulating(on assets and on per-chain rows) is a USD value too, not a token count: the same number asnominalSupplyValue. It equals the unit count only for USD pegs; divide by the peg’s USD rate for a EUR or gold peg’s units.markedMarketValueis circulating units multiplied by the observed USD price. It isnullwhen no usable price exists.- Supply changes are
nullwhen the prior-window observation is missing or zero, or when DeFi Llama repeats the supply for a day, a week and a month (a stalled adapter, not a flat supply); missing history is never reported as a flat0. priceModelisfixed-peg,nav-accrual, orunknown. Peg deviation and 30-day peg persistence arenullfor NAV-accrual assets such as USYC and USDY because appreciation is expected behavior, and for unverified yield-bearing share models so an accrued NAV is never mislabeled a depeg.pegDeviationis signed: negative below the reference peg (a discount), positive above it (-0.001is 0.1% below). Rank depegs by its absolute value.- Non-USD peg persistence compares every price observation with the reference FX or metal value from the same UTC day and weights observations by elapsed time. Historical supply and issuance use one reference-rate vector across the series, so FX or metal repricing is not counted as minting or redemption.
supplyTvlRatiois nominal stablecoin supply divided by reported chain DeFi TVL. It may exceed 1; it is not a composition share.- Velocity is annualized observed 24-hour DEX volume divided by supply. It is
withheld when measured deployments cover less than
0.70of supply (velocityCoverage) or when unmeasured non-EVM supply is material. InspectvelocityCoverageandvelocityUnavailableReason. assetConcentrationgroups the three largest stablecoin assets and the remainder. It does not aggregate assets by legal issuer.issuerSplitremains only as a deprecated compatibility alias.
totalApy from 0 to 10. Duplicate ticker symbols are linked only when
pool metadata identifies one stablecoin unambiguously; ambiguous matches are
omitted instead of being assigned to the largest same-symbol asset.
Sources: DeFiLlama stablecoin and yield feeds, CoinGecko on-chain volume and
price enrichment, and Sharpe’s Supabase cache. A degraded cache identifies
retained components rather than replacing failed upstream data with fresh
empty arrays.

