Skip to content
Sharpe AI

Stablecoins

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 is not served as current.

GET/v1/stablecoins/data

Get stablecoin data

Query parameters:

  • type: overview, detail, or yields. Default overview.
  • slug: stablecoin slug. Required when type=detail.
curl -G https://www.sharpe.ai/api/v1/stablecoins/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  --data-urlencode "type=overview"

Metric semantics

  • 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.
  • 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; 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.
  • 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.
  • supplyTvlRatioPct is nominal stablecoin supply divided by reported chain DeFi TVL. It may exceed 100%; 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 70% of supply or when unmeasured non-EVM supply is material. Inspect velocityCoveragePct 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 APY from 0% to 1,000%. 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.

curl -G https://www.sharpe.ai/api/v1/stablecoins/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  --data-urlencode "type=detail" \
  --data-urlencode "slug=usdt"

Was this page helpful?