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

### Table Details

| Property | Value |
| - | - |
| Table Name | `near.stablecoins.supply_distribution_daily` |
| Table Status | Production-Ready |
| Unique Key | `date`, `token_address` |

### Table Columns

| Column Name | Data Type | Description |
| - | - | - |
| date | TIMESTAMP\_NTZ(9) | End-of-day date (UTC) of the balance snapshot. |
| product\_id | VARCHAR(16777216) | Internal Allium identifier for the stablecoin product. Groups together the canonical and bridged variants of the same stablecoin on the same chain. |
| chain | VARCHAR(16777216) | Slug identifying the blockchain this record belongs to (e.g. `ethereum`, `base`, `avalanche`, `solana`). In per-chain tables this is always the same value; in cross-chain tables it identifies which chain the row came from. |
| token\_address | VARCHAR(16777216) | Contract address of the token. For EVM chains, native currency (e.g. ETH, MATIC) is represented as the zero address (0x0000000000000000000000000000000000000000). For Solana, this is the mint address. |
| token\_name | VARCHAR(16777216) | Full name of the token (e.g. "USD Coin", "Wrapped Ether"). |
| token\_symbol | VARCHAR(16777216) | Ticker symbol of the token (e.g. "USDC", "WETH"). |
| token\_decimals | NUMBER(38,0) | Number of decimal places used to represent the token's smallest unit. Used to convert raw amounts: normalized\_amount = raw\_amount / 10^decimals. For example, USDC has 6 decimals, so 2500000 raw units = 2.5 USDC. |
| total\_supply\_source | VARCHAR(16777216) | Method used to derive `total_supply` for this row: `state` (onchain totalSupply() call), `computed` (accumulated mint/burn Transfer events), `state_reconstructed` (reconstructed from state where no direct totalSupply() call is available), or `snapshot` (aggregated spot balances, used on Hyperliquid). |
| total\_supply\_raw | VARCHAR(16777216) | Total supply as string (same value as total\_supply for Hyperliquid). |
| total\_supply | FLOAT | Total token supply outstanding (minted minus burned). In token base units unless otherwise specified. |
| total\_supply\_usd | FLOAT | Total supply of this stablecoin in USD (circulating + non-circulating), at the snapshot timestamp. |
| circulating\_supply | FLOAT | Circulating supply of the token: `total_supply` minus `non_circulating_supply` (issuer\_basis layer). Represents tokens held outside issuer/treasury/bridge-escrow wallets, i.e. in public circulation. Derived from supply distribution (balances of non-circulating wallets), not from the mint/burn `supply_change` series, which tracks total supply. |
| circulating\_supply\_usd | FLOAT | Total value of all circulating tokens in USD |
| adjusted\_circulating\_supply | FLOAT | total\_supply minus adjusted\_non\_circulating\_supply (all layers). |
| adjusted\_circulating\_supply\_usd | FLOAT | Circulating supply (USD) after removing non-circulating balances. Best estimate of supply actively in use. |
| price\_usd | FLOAT | USD price per token unit for this row's asset and date, used to convert token amounts / supply into USD. |
| total\_supply\_details | VARIANT | Nested JSON breakdown of total supply sources: `state_supply` (onchain totalSupply snapshot) and `computed_supply` (mint/burn accumulation or chain-specific snapshot). |
| circulating\_supply\_details | VARIANT | Nested JSON breakdown of non-circulating supply by layer: `non_circulating_supply` (issuer\_basis) and `adjusted_non_circulating_supply` (all layers), each with balance, raw\_balance, and per-address-type details. |
| unique\_id | VARCHAR(16777216) | Allium's deterministic unique identifier for this row. Generated from the fields that uniquely identify the record (e.g. transaction hash + log index). Stable across full refreshes. |
| \_created\_at | TIMESTAMP\_NTZ(9) | Timestamp of when the entry was created in the database. |
| \_updated\_at | TIMESTAMP\_NTZ(9) | Timestamp of when the entry was last updated in the database. |
| \_changed\_since\_full\_refresh | BOOLEAN | Indicates if the record has changed since the last full data refresh. |
