Stablecoin Supply & Peg Monitor (Circulating, Depeg, Chains)

Here is one real result, with every field the actor returns (USDC, with the supply history and AI depeg-risk add-ons enabled):

{
  "id": "2",
  "name": "USD Coin",
  "symbol": "USDC",
  "pegType": "peggedUSD",
  "pegCurrency": "USD",
  "pegMechanism": "fiat-backed",
  "geckoId": "usd-coin",
  "price": 0.999786,
  "pegTarget": 1,
  "pegDeviationPct": -0.0214,
  "pegStatus": "on-peg",
  "circulating": 72873769590.19,
  "circulatingPrevDay": 72474059333.35,
  "circulatingPrevWeek": 72109792128.78,
  "circulatingPrevMonth": 73303229913.89,
  "change24hPct": 0.55,
  "change7dPct": 1.06,
  "change30dPct": -0.59,
  "dominantChain": "Ethereum",
  "chainCount": 132,
  "topChains": [
    { "chain": "Ethereum", "circulatingUsd": 46095369242.9, "pct": 63.25 },
    { "chain": "Solana", "circulatingUsd": 7229603744.6, "pct": 9.92 },
    { "chain": "Hyperliquid L1", "circulatingUsd": 6545225272.76, "pct": 8.98 },
    { "chain": "Base", "circulatingUsd": 4323553209.3, "pct": 5.93 },
    { "chain": "Arbitrum", "circulatingUsd": 2220595959.06, "pct": 3.05 }
  ],
  "chainBalanceUsd": null,
  "marketSharePct": 23.5209,
  "historyPoints": 2902,
  "historyStart": "2018-09-11",
  "historyEnd": "2026-08-21",
  "supply90dAgoUsd": 76637508732,
  "change90dPct": -4.85,
  "peakSupplyUsd": 79625059847,
  "peakSupplyDate": "2026-03-18",
  "recentSupplySeries": [
    { "date": "2026-05-24", "circulatingUsd": 76546057539 },
    { "date": "2026-05-31", "circulatingUsd": 75916857660 },
    { "date": "2026-06-07", "circulatingUsd": 75506165266 }
  ],
  "depegRiskLevel": "low",
  "collateralRisk": "fiat-backed lowest risk",
  "concentrationRisk": "high concentration on Ethereum",
  "depegNote": "Current peg deviation is minimal, indicating stability.",
  "depegSummary": "Monitor Ethereum's dominance as a potential risk factor.",
  "source": "defillama.com",
  "observedAt": "2026-08-21T13:24:28.000Z",
  "error": null
}

The most complete stablecoin supply and peg scraper available. It returns every field the source exposes for each stablecoin (circulating supply now and 1 day, 1 week and 1 month ago, price, peg type and mechanism, and its full per-chain distribution), plus derived fields (peg deviation, depeg status, 1D/7D/30D supply growth, dominant chain, chain count, top chains and market share), and gives you six filters to target exactly the stablecoins you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• Use cases
• FAQ and troubleshooting

What it does

The actor loads the full stablecoin universe (hundreds of stablecoins across every tracked chain), applies the filters you pass as input, and writes one normalized record per stablecoin to the run's dataset. Each record puts the whole picture in a single flat row: current circulating supply, price, peg deviation and depeg status, supply growth over 1 day, 7 days and 30 days, the per-chain distribution (dominant chain, chain count and the top chains by balance), and the stablecoin's share of the total stablecoin market.

Most stablecoin trackers give you only a total supply number. This one combines peg health, supply momentum, chain distribution and market share so you can spot a depeg or a supply outflow without stitching together several sources. Two optional add-ons deepen a run: a real supply history fetch (supply 90 days ago, 90-day growth, all-time peak supply and date, and a compact recent series), and an AI depeg-risk read (risk level, collateral risk, concentration risk and a short note).

Peg deviation is computed against the stablecoin's own peg currency (USD, EUR, GBP, JPY and more), so a euro stablecoin is measured against its euro peg, not the dollar.

Quickstart

Open the actor, paste this into the input, and press Run. It returns the three largest US dollar stablecoins with full supply, peg and per-chain data.

{
  "symbols": ["USDT", "USDC", "DAI"],
  "maxResults": 10
}

Leave symbols empty to rank the whole stablecoin market. Every input field is optional; with an empty input the actor returns the largest stablecoins by circulating supply (default maxResults is 10).

Input reference

Field	Type	Required	Default	Description
symbols	array	no	(all)	Filter to specific stablecoins by ticker symbol, matched exactly and case-insensitively, for example ["USDT","USDC","DAI"]. Empty returns all stablecoins.
pegType	string	no	(all)	Filter to one peg currency, for example peggedUSD, peggedEUR, peggedGBP, peggedJPY, peggedVAR.
pegMechanism	enum	no	(all)	How the peg is maintained: fiat-backed, crypto-backed or algorithmic. Algorithmic stablecoins carry the highest depeg risk.
minCirculatingUsd	integer	no	0	Only return stablecoins with at least this much circulating supply, in USD, for example 10000000.
chain	string	no	(all)	Only return stablecoins present on this chain, and report that chain's balance in chainBalanceUsd, for example Ethereum, Tron, Solana, Base, Arbitrum.
sortBy	enum	no	circulating	circulating = largest supply first, change7d = fastest 7-day supply growth first, pegDeviation = furthest off peg first.
includeHistory	boolean	no	false	Paid add-on, off by default. Fetch the aggregate supply time series and attach supply 90 days ago, 90-day growth, peak supply and date, and a recent series. Disabled on free plans.
aiDepegRisk	boolean	no	false	Paid add-on, off by default. Add an AI depeg risk level, collateral risk, concentration risk and note. Disabled on free plans.
maxResults	integer	no	10	Maximum number of stablecoins to return across the run, after filtering and sorting. Free Apify plans are capped at 10 per run.

Filters combine with logical AND. If you pass no filters at all, the actor returns the largest stablecoins by circulating supply.

Output reference

One dataset item per stablecoin. Types: string, number, array, or null when the source value is absent.

Field	Type	Description
id	string	Source stablecoin identifier.
name	string	Stablecoin name, for example USD Coin.
symbol	string	Ticker symbol, for example USDC.
pegType	string	Peg currency code, for example peggedUSD, peggedEUR, peggedVAR.
pegCurrency	string	Peg currency label parsed from pegType, for example USD, EUR.
pegMechanism	string	How the peg is maintained: fiat-backed, crypto-backed or algorithmic.
geckoId	string	CoinGecko id for the stablecoin.
price	number	Current price of the stablecoin in its peg currency.
pegTarget	number	Peg target value: 1 unit of the peg currency.
pegDeviationPct	number	Percent deviation of price from the peg target.
pegStatus	string	on-peg if absolute deviation is under 0.5%, depegged-minor from 0.5% to 2%, depegged-major above 2%.
circulating	number	Current circulating supply, in USD (peg-currency units).
circulatingPrevDay	number	Circulating supply one day ago, in USD.
circulatingPrevWeek	number	Circulating supply one week ago, in USD.
circulatingPrevMonth	number	Circulating supply one month ago, in USD.
change24hPct	number	Percent change in circulating supply over the last 24 hours.
change7dPct	number	Percent change in circulating supply over the last 7 days.
change30dPct	number	Percent change in circulating supply over the last 30 days.
dominantChain	string	Chain holding the largest share of current supply.
chainCount	number	Number of chains the stablecoin is present on with a positive balance.
topChains	array	Top 5 chains by current balance, each with chain, circulatingUsd and pct of on-chain supply.
chainBalanceUsd	number	Balance on the chain named in the chain filter, in USD. null when no chain filter is set.
marketSharePct	number	This stablecoin's share of total circulating stablecoin supply, in percent.
historyPoints	number	Number of history points returned. Supply history add-on.
historyStart	string	First date of the supply history series. Supply history add-on.
historyEnd	string	Last date of the supply history series. Supply history add-on.
supply90dAgoUsd	number	Circulating supply about 90 days ago, in USD. Supply history add-on.
change90dPct	number	Percent change in circulating supply over the last 90 days. Supply history add-on.
peakSupplyUsd	number	All-time peak circulating supply in the series, in USD. Supply history add-on.
peakSupplyDate	string	Date of the all-time peak supply. Supply history add-on.
recentSupplySeries	array	Compact recent supply series, each with date and circulatingUsd. Supply history add-on.
depegRiskLevel	string	AI depeg risk level: low, medium or high. AI add-on.
collateralRisk	string	AI read on collateral / backing risk. AI add-on.
concentrationRisk	string	AI read on single-chain concentration risk. AI add-on.
depegNote	string	AI note on the main risk driver. AI add-on.
depegSummary	string	AI one-line actionable risk summary. AI add-on.
source	string	Data source.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed or empty run, a single item with a populated error field is written instead.

Derived field notes

• pegDeviationPct is (price - pegTarget) / pegTarget * 100, with pegTarget fixed at 1 unit of the stablecoin's own peg currency, so non-USD stablecoins are measured against their own peg.
• pegStatus buckets the absolute deviation into on-peg, depegged-minor and depegged-major.
• change24hPct, change7dPct and change30dPct are computed from the current supply against the prior day, week and month supply.
• marketSharePct divides this stablecoin's circulating supply by the total circulating supply across every stablecoin, computed before filtering.

Example output record

Real record from a live run (input {"pegMechanism": "algorithmic", "sortBy": "pegDeviation", "maxResults": 8}), showing a collapsed stablecoin surfaced by the peg-deviation sort:

{
  "id": "12",
  "name": "Neutrino USD",
  "symbol": "USDN",
  "pegType": "peggedUSD",
  "pegCurrency": "USD",
  "pegMechanism": "algorithmic",
  "price": 0.015907,
  "pegTarget": 1,
  "pegDeviationPct": -98.4093,
  "pegStatus": "depegged-major",
  "circulating": 6504254,
  "change24hPct": 0,
  "change7dPct": 0,
  "change30dPct": 0,
  "dominantChain": "Waves",
  "chainCount": 4,
  "topChains": [
    { "chain": "Waves", "circulatingUsd": 6398753.09, "pct": 98.38 },
    { "chain": "Ethereum", "circulatingUsd": 101790.34, "pct": 1.56 },
    { "chain": "BSC", "circulatingUsd": 3345.74, "pct": 0.05 },
    { "chain": "Polygon", "circulatingUsd": 364.81, "pct": 0.01 }
  ],
  "chainBalanceUsd": null,
  "marketSharePct": 0.0021,
  "source": "defillama.com",
  "observedAt": "2026-08-21T13:23:35.207Z",
  "error": null
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~stablecoin-supply-peg-monitor/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"symbols":["USDT","USDC","DAI"],"maxResults":10}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~stablecoin-supply-peg-monitor/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"pegMechanism":"algorithmic","sortBy":"pegDeviation","maxResults":25}'

Apify CLI:

apify call scrapers_lat/stablecoin-supply-peg-monitor \
  --input '{"chain":"Solana","minCirculatingUsd":10000000,"maxResults":50}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=100&limit=100"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

This actor uses pay-per-event billing. You are charged only for genuine results.

• apify-actor-start is charged once per run, when the actor starts.
• result is the primary event, charged once per stablecoin record returned (circulating supply, price, peg deviation and status, 1D/7D/30D supply growth, per-chain distribution and market share).
• supply_history is an optional add-on, off by default. Turn it on with includeHistory: true. It performs a genuine extra fetch of the stablecoin's aggregate supply history and is charged only when a real history series is returned.
• ai_depeg_risk is an optional add-on, off by default. Turn it on with aiDepegRisk: true. It runs an AI risk read and is charged only when the model returns a usable analysis.
• No charge on failure. If a run errors or matches nothing, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Add-ons are opt-in and paying-only. Both add-ons are off by default and are automatically disabled on free Apify plans, so they never fire without your action.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxResults.

See the pricing tab for current per-event prices.

Use cases

• Stablecoin supply monitoring. Track circulating supply for USDT, USDC, DAI and hundreds more, with 1-day, 7-day and 30-day growth in every row, to see mints and redemptions as they happen.
• Depeg risk and peg stability alerts. Sort by pegDeviation or filter by pegMechanism: algorithmic to surface stablecoins drifting off peg before they make headlines, with a clear pegStatus on each one.
• On-chain macro research. Measure total stablecoin liquidity and how it is shifting between fiat-backed, crypto-backed and algorithmic designs.
• Treasury and risk management. Watch the peg health, supply trend and collateral type of the stablecoins your treasury holds, and add the AI depeg-risk read for a fast qualitative check.
• Chain-level stablecoin flows. Use the per-chain distribution and the chain filter to see where stablecoin liquidity sits and how it moves between Ethereum, Tron, Solana, Base and other chains.
• Market-share tracking. Rank issuers by marketSharePct to follow concentration and competition across the stablecoin market.
• DeFi analytics. Feed clean, flat stablecoin supply and peg data into dashboards, backtests and monitoring pipelines without maintaining your own collectors.

FAQ and troubleshooting

A run returned 0 records. Why? The filter combination matched nothing. Loosen filters (remove symbols or chain, lower minCirculatingUsd), or check the symbol spelling. Zero-result runs are not charged.

How do I find stablecoins that are off peg? Set sortBy to pegDeviation to rank by distance from peg, or read pegStatus on each record. Combine with pegMechanism: algorithmic to focus on the highest-risk designs.

How is peg deviation calculated for non-USD stablecoins? Each stablecoin is measured against its own peg currency (pegType). A euro stablecoin is compared to a target of 1 EUR, a yen stablecoin to 1 JPY, and so on, so deviation reflects the real peg, not the dollar.

What does the chain filter do? It keeps only stablecoins that have a positive balance on that chain and fills chainBalanceUsd with the amount on that chain. The rest of the record (supply, peg, growth, distribution) still reflects the whole stablecoin.

What extra data do the add-ons return? includeHistory adds a real supply history: supply 90 days ago, 90-day growth, all-time peak supply and its date, and a compact recent series. aiDepegRisk adds a risk level, collateral risk, concentration risk and a short note. Both are off by default and only run when you enable them on a paid plan.

Is this an official tool? No. This actor is independent and has no affiliation with any stablecoin issuer or data provider. It reads only publicly available data.

Related scrapers

• DeFi Yield Pools Scraper: live APY, TVL and impermanent-loss risk for thousands of DeFi liquidity pools.
• DefiLlama Protocols Scraper: protocol TVL, chains and category across DeFi.
• SEC EDGAR Company Filings Scraper: SEC filings by ticker or CIK.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with any stablecoin issuer or data provider. Accesses only publicly available data.