stablecoins_solana.balances_enriched table extends Solana stablecoin balances with address classification, whale flags, and a circulating supply flag.
Why these enriched tables matter
Stablecoin analysis comes down to two fundamental questions:- Where are stablecoins right now? (balances)
- How did they get there? (activity)
Table schema
Address categories
Every address receives exactly oneaddress_category — no double counting is possible by construction. When an address matches a curated label, that label wins. Unlabeled addresses fall through: >= $10M balance → unidentified_whale, otherwise → unidentified.
When an address appears in multiple label sets, a fixed priority order resolves the conflict (table is ordered by priority, highest first):
As label coverage expands, new values may be added in backward-compatible fashion.
Methodology
- Start from daily rows in
stablecoins_solana.balances. - Join curated Solana address labels to assign category, subcategory, and project metadata where available.
- Derive
is_whale(>= $10M total stablecoin balance) andis_circulating(true unless the address is a bridge escrow / issuer bridge escrow / CEX locked-token wallet) flags per address per day. - Apply the priority waterfall for unlabeled addresses to maintain complete coverage.
Sample query
Notes
- For performance, filter by
blockchainandday. - For circulating supply, filter
WHERE is_circulating = true. For bridge exposure, filterWHERE address_category = 'bridge'. Both are intentionally retained in the table.