Stablecoins are crypto assets pegged to a reference value — typically USD — and are the dominant settlement asset on most EVM chains. Allium normalizes every supported stablecoin into one schema so you can measure issuance, distribution, and on-chain settlement consistently across issuers and chains.Documentation Index
Fetch the complete documentation index at: https://docs.allium.so/llms.txt
Use this file to discover all available pages before exploring further.
Supply Distribution Methodology
Total supply
Total supply is the quantity of tokens minted on the blockchain as reported by the token contract at each daily observation. It includes all tokens regardless of who holds them or whether they are accessible — the gross figure before any non-circulating deductions are applied.Non-circulating supply
Non-circulating supply is the portion of total supply that is not accessible for general use on that chain. Allium identifies and deducts four categories:- Pre-minted and unissued supply — Tokens held by the issuer that have been minted onchain but are not yet backed by real-world assets and have not entered general circulation. Counting them would overstate the stablecoin’s economic footprint.
- Bridge-locked supply — Tokens deposited into bridging contracts on the source chain. When a token is bridged, source-chain tokens are locked while a representation is minted on the destination chain. The locked supply is excluded to reflect actual onchain availability and to avoid double-counting the same economic exposure on both chains.
- Stablecoin-backed supply — Tokens locked as collateral to mint other stablecoins tracked in this dataset. Excluding this prevents double-counting the same economic exposure across two separate instruments.
- Permanently inaccessible supply — Tokens sent to burn addresses or other contracts from which they cannot be recovered. Mathematically part of total supply, but with no economic utility.
What counts as circulating
Supply locked in DeFi contracts, held on centralized exchanges, or sitting in dormant wallets is treated as circulating. These tokens remain accessible to their owners and represent genuine economic exposure — they are part of the usable supply even if temporarily inactive. The circulating supply metric is a measure of availability, not activity.Address curation
Identifying non-circulating addresses is an ongoing process that combines onchain signals with Allium’s entity resolution layer: historical balance patterns (large, static issuer/bridge custody), transfer activity (addresses that only receive, or only participate in mint/bridge operations), tracing newly minted tokens to their initial recipients, wallet funding patterns, and proprietary entity labels for known bridges, issuer wallets, and protocol contracts. Curation is updated as new contracts, bridges, and issuer wallets are identified, and applied to historical data where possible.Coverage caveats
- Circulating supply is computed per chain. Multi-chain deployments show separate figures per chain; cross-chain aggregation requires deduplicating bridge-locked supply (which Allium handles via the bridge-locked exclusion above).
- All supply data is sourced from onchain contract state. Off-chain liabilities, pending redemptions, and issuer balance sheet information are not reflected.
- Figures may be revised as address coverage improves.
Models
| Model | Description |
|---|---|
| Transfers | Every on-chain stablecoin transfer, enriched with token metadata and USD value |
| Balances Daily | Daily closing balance per (address, stablecoin), with USD valuation |
| Supply Change | Mint and burn events that change a stablecoin’s on-chain total supply |
| Supply Distribution Daily | Daily total, circulating, and non-circulating supply per stablecoin and chain |
| Supply Non Circulating Daily | Per-address breakdown of the balances excluded from circulating supply |
| Supply Non Circulating EOD | End-of-day source rows underlying Supply Non Circulating Daily |