The Stablecoins Supply Distribution Daily table contains one row per (date, chain, stablecoin) breaking the day’s on-chain supply into total, non-circulating, and the derived circulating supply. Non-circulating supply is the sum of four exclusion categories (pre-minted/unissued, bridge-locked, stablecoin-backed, permanently inaccessible) — see Supply Distribution Methodology on the stablecoins overview for the full methodology. Total supply is reconciled from two sources — the contract’s reportedDocumentation Index
Fetch the complete documentation index at: https://docs.allium.so/llms.txt
Use this file to discover all available pages before exploring further.
totalSupply() state (_state) and the Allium-computed cumulative of mint and burn events (_computed) — with a total_supply_source flag indicating which one is authoritative for the row.
Table Columns
Unique Key:date, chain, token_address
| Column Name | Data Type | Description |
|---|---|---|
| date | TIMESTAMP_NTZ(9) | The UTC date this supply snapshot covers |
| product_id | VARCHAR | Allium stablecoin product identifier (e.g. usdc, usdt) |
| chain | VARCHAR | The blockchain the stablecoin resides on |
| token_address | VARCHAR | Contract address of the stablecoin token |
| token_name | VARCHAR | Name of the stablecoin |
| token_symbol | VARCHAR | Symbol of the stablecoin |
| token_decimals | INTEGER | Decimal precision of the stablecoin |
| total_supply_raw_state | VARCHAR | Total supply read from totalSupply() contract state, unnormalized |
| total_supply_state | FLOAT | Total supply read from totalSupply() contract state, normalized |
| block_number_fetched | INTEGER | Block number at which the contract-state supply was fetched |
| block_timestamp_fetched | TIMESTAMP_NTZ(9) | Block timestamp at which the contract-state supply was fetched |
| total_supply_raw_computed | VARCHAR | Total supply derived from cumulative mint/burn events, unnormalized |
| total_supply_computed | FLOAT | Total supply derived from cumulative mint/burn events, normalized |
| block_number_last_change | INTEGER | Block number of the last supply-changing event included in the computed total |
| supply_change_details | OBJECT | Breakdown of the day’s mint/burn events that contributed to the supply change |
| non_circulating_supply | FLOAT | Sum of balances excluded from circulation across the four methodology categories (pre-minted, bridge-locked, stablecoin-backed, permanently inaccessible), normalized |
| non_circulating_supply_raw | FLOAT | Same as non_circulating_supply but unnormalized |
| non_circulating_supply_details | VARIANT | Per-address / per-category breakdown of non_circulating_supply |
| adjusted_non_circulating_supply | FLOAT | Non-circulating supply with additional issuer-specific exclusions applied (see supply_non_circulating_daily.ncs_supply_layer) |
| adjusted_non_circulating_supply_raw | FLOAT | Same as adjusted_non_circulating_supply but unnormalized |
| adjusted_non_circulating_supply_details | VARIANT | Per-address breakdown of adjusted_non_circulating_supply |
| total_supply_source | VARCHAR | Indicates whether total_supply came from contract state or computed events |
| total_supply_raw | VARCHAR | Reconciled total supply, unnormalized |
| total_supply | FLOAT | Reconciled total supply, normalized |
| circulating_supply | FLOAT | total_supply minus non_circulating_supply |
| adjusted_circulating_supply | FLOAT | total_supply minus adjusted_non_circulating_supply |
| unique_id | VARCHAR | Unique identifier for the (date, chain, token) row |