Database structure
Each blockchain has its own database in Snowflake:Naming convention: Databases are typically named
[BLOCKCHAIN]_CORE for free shares or
[BLOCKCHAIN]_PREMIUM for premium shares.Schema breakdown
Core schema (Free + Premium)
The Core schema contains foundational blockchain data—blocks, transactions, logs, and basic token transfers.Fact tables
Fact tables
Raw blockchain data organized by entity type.Common tables:
fact_blocks- Block-level data (timestamps, gas used, tx counts)fact_transactions- All transactions with gas, value, success statusfact_event_logs- Raw event logs emitted by contractsfact_traces- Internal transactions and calls (EVM chains)fact_token_transfers- Native and fungible token transfers
- Highest data volume
- Most frequently updated (30 min - 1 hour latency)
- Optimal for raw blockchain analysis
Dimension tables
Dimension tables
Reference data and metadata for enrichment.Common tables:
dim_contracts- Contract addresses with metadatadim_labels- Address labels (exchanges, protocols, etc.)dim_contract_abis- Contract ABIs for decoding
- Lower update frequency (daily updates)
- Used for joining with fact tables
- Provides context and human-readable names
EZ (Easy) tables
EZ (Easy) tables
Simplified, curated views of core data.Common tables:
ez_token_transfers- Decoded token transfers with USD valuesez_decoded_event_logs- Human-readable event logsez_current_balances- Current token balances by addressez_native_transfers- Native token transfers (ETH, SOL, etc.)
- Pre-joined with labels and metadata
- Includes USD pricing where applicable
- Easier to query for common use cases
Free shares include the entire Core schema. This is often sufficient for raw blockchain
analysis, token tracking, and custom analytics.
DeFi schema (Premium only)
The DeFi schema contains curated DeFi protocol data—swaps, lending, liquidity, bridges, and more.DEX tables
DEX tables
Decentralized exchange activity.Common tables:
ez_dex_swaps- All DEX swaps with USD valuesfact_dex_swaps- Raw DEX swap eventsdim_dex_liquidity_pools- Pool metadata
- Trading volume analysis
- Liquidity tracking
- Price discovery
- Arbitrage detection
Lending tables
Lending tables
Lending protocol activity (Aave, Compound, etc.).Common tables:
ez_lending_deposits- Deposit events with USD valuesez_lending_borrows- Borrow events with USD valuesez_lending_repayments- Repayment eventsez_lending_liquidations- Liquidation eventsez_lending_flashloans- Flash loan activity
- TVL tracking
- Risk monitoring
- Liquidation analysis
- Interest rate tracking
Liquidity tables
Liquidity tables
Liquidity pool actions (adds, removes).Common tables:
ez_liquidity_pool_actions- LP adds and removesdim_liquidity_pools- Pool reference data
- Liquidity provision analysis
- Impermanent loss calculations
- Pool performance tracking
Bridge tables
Bridge tables
Cross-chain bridge activity.Common tables:
ez_bridge_activity- Bridge transfers with USD valuesfact_bridge_transfers- Raw bridge events
- Cross-chain flow analysis
- Bridge volume tracking
- Capital migration patterns
Staking tables
Staking tables
Staking and governance activity.Common tables:
ez_staking- Staking deposits and withdrawalsfact_staking_events- Raw staking events
- Staking participation tracking
- Validator analysis
- Reward distribution
NFT schema (Premium only)
The NFT schema contains NFT marketplace and transfer data.NFT sales
NFT sales
Marketplace sales across all major platforms.Common tables:
ez_nft_sales- All NFT sales with USD valuesfact_nft_sales- Raw sale events
- OpenSea
- Blur
- LooksRare
- X2Y2
- Magic Eden (Solana)
- And more…
- Sales volume tracking
- Floor price monitoring
- Whale activity analysis
- Collection performance
NFT transfers
NFT transfers
All NFT transfer events (ERC-721, ERC-1155, etc.).Common tables:
ez_nft_transfers- Decoded NFT transfersfact_nft_transfers- Raw transfer events
- Holder distribution
- Transfer patterns
- Wash trading detection
NFT metadata
NFT metadata
Collection and token metadata.Common tables:
dim_nft_collections- Collection-level metadatadim_nft_metadata- Token-level attributes
- Collection discovery
- Rarity analysis
- Metadata enrichment
Price schema (Premium only)
The Price schema contains historical price data for tokens and assets.Price tables
Price tables
OHLC price data at various granularities.Common tables:
ez_prices_hourly- Hourly OHLC + volumefact_prices- Raw price points
- Aggregated from multiple sources
- Includes volume data
- Cross-chain coverage
- Historical data available
- Historical price analysis
- Correlation studies
- Arbitrage detection
- Portfolio valuation
Asset metadata
Asset metadata
Token and asset reference data.Common tables:
dim_asset_metadata- Asset symbols, decimals, etc.
- Price joins
- Asset identification
- Symbol normalization
Stats schema (Premium only)
The Stats schema contains pre-computed metrics and aggregations.Core metrics
Core metrics
Blockchain-level statistics.Common tables:
ez_core_metrics_hourly- Hourly chain statsez_core_metrics_daily- Daily chain stats
- Transaction counts
- Active addresses
- Gas metrics
- Fee statistics
Protocol metrics
Protocol metrics
Protocol-specific aggregates.Common tables:
ez_defi_metrics_daily- DeFi protocol statsez_nft_metrics_daily- NFT collection stats
- Dashboard creation
- Trend analysis
- Comparative metrics
- Performance optimization (pre-aggregated)
Protocol-specific schemas (Premium only)
Some blockchains include additional schemas for major protocols.- Ethereum
- Solana
- Other chains
- MAKER - MakerDAO governance and vaults
- ENS - Ethereum Name Service registrations
- BEACON - Ethereum 2.0 beacon chain data
- L2 - Layer 2 rollup data
Schema naming patterns
Flipside uses consistent naming conventions across all blockchains:Table prefixes
| Prefix | Description | Example |
|---|---|---|
fact_ | Raw fact tables (large, frequently updated) | fact_transactions |
dim_ | Dimension tables (reference data) | dim_labels |
ez_ | Easy tables (curated, pre-joined) | ez_token_transfers |
Schema organization
Choosing the right schema
Use Core for
- Raw blockchain exploration
- Custom event decoding
- Token transfer analysis
- Building custom metrics
- Maximum flexibility
Use DeFi for
- DEX analytics - Lending protocol tracking - TVL calculations - Bridge flow analysis - Cross-protocol comparisons
Use NFT for
- NFT sales tracking - Collection performance - Marketplace analytics - Holder distribution - Rarity analysis
Use Price for
- Historical pricing - USD value conversions - Arbitrage detection - Portfolio valuation - Correlation analysis
Use Stats for
- Dashboard creation - Pre-aggregated metrics - Performance optimization - Trend analysis - Quick insights
Use Protocol-specific for
- Protocol-specific analysis
- Governance tracking
- Specialized metrics
- Deep dives
Common query patterns
Start with Core, join with DeFi
Enrich with labels and prices
Use Stats for quick insights
Schema-specific documentation
For detailed table structures and column definitions:Ethereum
Ethereum-specific tables and schemas
Solana
Solana-specific tables and schemas
Other chains
Additional blockchain documentation coming soon