Skip to main content
Track stablecoin nominal supply, live marked value, peg behavior, mechanism mix, chain supply, detail views, and yield data. Data refreshes hourly. Responses include 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, or yields. Default overview.
  • slug: stablecoin slug. Required when type=detail.

Metric semantics

  • Shares (marketShare, supplyShare, velocityCoverage, velocityNonEvmShare and the pegStability30d bands), supply changes (supplyChange24h, supplyChange7d, supplyChange30d), pegDeviation, supplyTvlRatio and the yield figures (totalApy, baseApy, rewardApy, totalApyChange7d and their best* counterparts on each row) are fractions: 0.054 is 5.4%, and an APY is per year. totalApyChange7d is the difference of two APYs, not a relative change.
  • nominalSupplyValue is circulating units translated to USD at the asset’s reference peg. The legacy marketCap field 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 as nominalSupplyValue. It equals the unit count only for USD pegs; divide by the peg’s USD rate for a EUR or gold peg’s units.
  • markedMarketValue is circulating units multiplied by the observed USD price. It is null when no usable price exists.
  • Supply changes are null when 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 flat 0.
  • priceModel is fixed-peg, nav-accrual, or unknown. Peg deviation and 30-day peg persistence are null for 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.
  • pegDeviation is signed: negative below the reference peg (a discount), positive above it (-0.001 is 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.
  • supplyTvlRatio is 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.70 of supply (velocityCoverage) or when unmeasured non-EVM supply is material. Inspect velocityCoverage and velocityUnavailableReason.
  • assetConcentration groups the three largest stablecoin assets and the remainder. It does not aggregate assets by legal issuer. issuerSplit remains only as a deprecated compatibility alias.
Yield rows include only single-asset pools with at least $100,000 TVL and a finite 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.