crosschain.balances Table: ez_ink_balances_native_daily Type: View
What
This convenience table provides a comprehensive view of daily native asset balance snapshots (ETH, AVAX, BNB, etc.) with enriched metadata including decimal adjustments, USD values, and blockchain information. It simplifies native asset balance analysis by capturing end-of-day holdings for each address through directeth_getBalance RPC calls across all supported EVM blockchains. It contains columns for the blockchain and native token symbol, which are important filters and join keys. See evm.dim_chains for a list of all supported EVM chains.
Note: This is a unified view that combines native balance data from multiple EVM blockchains. Each row includes a blockchain identifier and native_token symbol to distinguish between different networks.
Key Use Cases
- Daily portfolio tracking and native asset balance monitoring across multiple blockchains
- Historical native asset balance analysis and trend identification by network
- Whale tracking and large holder distribution analysis per blockchain
- Daily balance snapshots for reporting and analytics across EVM chains
- Native asset concentration analysis across addresses and blockchains
- Daily balance-based yield and return calculations for native assets
- Cross-chain native asset holding comparisons and analysis
Important Relationships
- Join with evm__fact_blocks: Use
block_numberandblockchainfor block metadata and timestamps - Join with core__dim_labels: Use
addressandblockchainfor entity identification and categorization - Complement to balances__ez_balances_erc20_daily: Complete picture of token holdings across networks
- Join with evm__ez_native_transfers: Compare daily balances with transfer activity by blockchain
- Join with evm__fact_traces: Analyze native asset movement patterns per network
Commonly-used Fields
blockchain: The blockchain network (e.g., ‘ethereum’, ‘polygon’, ‘arbitrum’)native_token: The native token symbol for the blockchain (e.g., ‘ETH’, ‘MATIC’, ‘AVAX’)address: The account address holding the native asset balancebalance: Native asset balance at end of day, decimal adjusted to standard unitsbalance_usd: USD value of the native asset balance at end of daybalance_raw: Raw balance in smallest unit (Wei) without decimal adjustmentbalance_precise: Precise decimal-adjusted balance as stringbalance_hex: Hexadecimal balance as returned by eth_getBalancedecimals: Number of decimal places (always 18 for native assets)block_date: The date for which this balance snapshot was taken
Sample queries
Daily Native Asset Holdings by AddressColumns
| Column Name | Data Type | Description |
|---|---|---|
| BLOCKCHAIN | TEXT | The blockchain the record occurred on. See evm.dim_chains for a list of all EVM chains. Format: VARCHAR Example: ‘ethereum’ Usage: Filtering by blockchain Joining across tables Analyzing chain-specific patterns |
| NATIVE_TOKEN | TEXT | The native token symbol for the blockchain. See evm.dim_chains for a list of all EVM chains. Format: VARCHAR Example: ‘ETH’ |
| BLOCK_NUMBER | NUMBER | Sequential counter representing the position of a block in the blockchain since genesis (block 0). Key Facts: Immutable once finalized Primary ordering mechanism for blockchain data Increments by 1 for each new block Used as a proxy for time in many analyses Usage in Queries: Important: Block numbers are chain-specific. Block 15000000 on Ethereum ≠ block 15000000 on Polygon. |
| BLOCK_DATE | DATE | The date for which this balance snapshot represents the end-of-day native asset balance. Example: ‘2023-12-15’ |
| ADDRESS | TEXT | The account address whose native asset balance is recorded in this daily snapshot. Example: ‘0x1234567890123456789012345678901234567890’ |
| DECIMALS | NUMBER | Number of decimal places for the native asset. Typically 18 for native EVM assets (ETH, AVAX, BNB, etc.). Example: 18 |
| BALANCE_HEX | TEXT | Hexadecimal representation of the native asset balance as returned by the eth_getBalance RPC call. Example: ‘0x3b9aca00’ |
| BALANCE_RAW | NUMBER | Native asset balance in the smallest unit (Wei) without decimal adjustment, as returned by eth_getBalance. Example: 1000000000000000000 |
| BALANCE_PRECISE | TEXT | Native asset balance with proper decimal adjustment, returned as a string to preserve precision. Example: ‘1.000000000000000000’ |
| BALANCE | FLOAT | Native asset balance with decimal adjustment converted to a float for easier mathematical operations. Example: 1.0 |
| BALANCE_USD | FLOAT | USD value of the native asset balance at the end of the day, calculated using hourly price data. Example: 2500.75 |
| EZ_BALANCES_NATIVE_DAILY_ID | TEXT | Primary key - unique identifier for each row ensuring data integrity. Format: Usually VARCHAR containing composite key generated using MD5 hash of the relevant columns. Example: MD5(blocknumber, txhash, trace_index) Usage: Deduplication in incremental loads Join operations for data quality checks Troubleshooting specific records Important: Implementation varies by table - check table-specific documentation. |
| INSERTED_TIMESTAMP | TIMESTAMP_NTZ | UTC timestamp when the record was first added to the Flipside database. Format: TIMESTAMP_NTZ Use Cases: Data freshness monitoring Incremental processing markers Debugging data pipeline issues SLA tracking Query Example: |
| MODIFIED_TIMESTAMP | TIMESTAMP_NTZ | UTC timestamp of the most recent update to this record. Format: TIMESTAMP_NTZ Triggers for Updates: Data corrections Enrichment additions Reprocessing for accuracy Schema migrations Monitoring Usage: |