hyperevm.core Table: dim_labels Type: 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. |
| CREATOR | TEXT | The source or creator of this label entry. Labels from verified sources may be more reliable. |
| ADDRESS | TEXT | The blockchain address (0x format) that this label describes. Lowercase hex string used as primary key for joining. |
| ADDRESS_NAME | TEXT | The most specific, granular label for this address. Provides maximum detail for precise identification. |
| LABEL_TYPE | TEXT | High-level category describing the address’s primary function. Core types include cex, dex, defi, token, nft, bridge, games, whale, institution, and l2. |
| LABEL_SUBTYPE | TEXT | Specific categorization within the label type. Used for detailed filtering within broader categories. |
| LABEL | TEXT | High-level label identifying the general entity or wallet type. Often combines project_name with label_subtype. |
| DIM_LABELS_ID | TEXT | Primary key - unique identifier for each row ensuring data integrity. |
| INSERTED_TIMESTAMP | TIMESTAMP_NTZ | UTC timestamp when the record was first added to the Flipside database. |
| MODIFIED_TIMESTAMP | TIMESTAMP_NTZ | UTC timestamp of the most recent update to this record. |