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