optimism.core Table: dim_labels Type: Base Table
What
The labels table is a critical dimension for blockchain analysis, providing one-to-one address identifiers that transform opaque addresses into recognizable entities. Labels are categorized into types (cex, dex, defi, etc.) and subtypes (hot_wallet, treasury, etc.) to enable sophisticated filtering and analysis.Key Use Cases
- Track centralized exchange flows (deposits, withdrawals, hot/cold wallet movements)
- Analyze DeFi protocol usage and cross-protocol interactions
- Monitor whale and institutional wallet activities
- Identify token contracts and their movements
- Assess labeling coverage for active addresses
- Create entity-based transaction flow analysis
Important Relationships
- Join with fact_transactions: Identify exchange flows, protocol usage
- Join with ez_token_transfers: Track token movements by entity type
- Join with dim_contracts: Combine with contract metadata
Commonly-used Fields
address: Primary key for joining with transaction tableslabel_type: High-level category (cex, dex, defi, token, etc.)label_subtype: Specific categorization within type (hot_wallet, pool, etc.)project_name: Protocol or entity nameaddress_name: Most specific, granular labelblockchain: Network identifier for multi-chain queries
Sample Queries
Exchange Flow AnalysisColumns
| Column Name | Data Type | Description |
|---|---|---|
| BLOCKCHAIN | TEXT | The blockchain network for this label. Required for multi-chain label queries. |
- Deduplication in incremental loads
- Join operations for data quality checks
- Troubleshooting specific records
- Data freshness monitoring
- Incremental processing markers
- Debugging data pipeline issues
- SLA tracking