> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sharpe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Stablecoins API

> Track stablecoin supply at peg, marked value, peg behavior, mechanisms, chain supply, coverage, and yield data through the Sharpe API.

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`.

```bash theme={null}
curl -G https://www.sharpe.ai/api/v1/stablecoins/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  --data-urlencode "type=overview"
```

## 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.

```bash theme={null}
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"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.