| 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_TIMESTAMP | TIMESTAMP_NTZ | UTC timestamp when the block was produced by validators/miners. Format: TIMESTAMP_NTZ (no timezone) Precision: Second-level accuracy Reliability: Set by block producer Can have minor variations (±15 seconds) Always increasing (newer blocks = later timestamps) Best Practices: Note: Use for time-series analysis, but be aware that block production rates vary by chain. |
| TX_HASH | TEXT | Unique 66-character identifier for the transaction. Format: 0x + 64 hexadecimal characters Usage: Primary key for transaction lookups Join key for traces, logs, and token transfers Immutable once confirmed Example: 0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060 |
| CONTRACT_ADDRESS | TEXT | Smart contract address that emitted this event or received the transaction. Key Points: Always the immediate event emitter for logs May differ from transaction to_address Lowercase normalized format Never NULL for valid events |
| EVENT_NAME | TEXT | The event name as defined in the contract’s ABI. Format: PascalCase event identifier Examples: Transfer - Token transfers Swap - DEX trades OwnershipTransferred - Admin changes Approval - Token approvals Usage Pattern: |
| EVENT_INDEX | NUMBER | Zero-based sequential position of the event within a transaction’s execution. Key Facts: Starts at 0 for first event Increments across all contracts in transaction Preserves execution order Essential for deterministic event ordering Usage Example: |
| ORIGIN_FUNCTION_SIGNATURE | TEXT | Function signature (first 4 bytes) of the called method. Format: 0x + 8 hex characters Common Signatures: 0xa9059cbb: transfer(address,uint256) 0x095ea7b3: approve(address,uint256) 0x23b872dd: transferFrom(address,address,uint256) Note: NULL for simple transfers or invalid calls |
| ORIGIN_FROM_ADDRESS | TEXT | The externally-owned account (EOA) or contract address that initiated the transaction. Key Points: Always 42 characters (0x + 40 hex chars) Lowercase normalized in all tables Cannot be NULL for valid transactions For contract creation: sender of creation transaction Common Patterns: EOA → EOA: Simple transfer EOA → Contract: User interaction Contract → Contract: Internal calls (see fact_traces) Known addresses: Exchange hot wallets, protocol deployers Query Examples: |
| ORIGIN_TO_ADDRESS | TEXT | The destination address for the transaction - either an EOA or contract address. Special Cases: NULL: Contract creation transaction Contract address: Interacting with smart contract EOA address: Simple transfer or receiving funds Important Patterns: Note: For token transfers, this is the token contract, not the recipient. See eztokentransfers tables for recipient. |
| PLATFORM | TEXT | The lending protocol where the transaction occurred. Example: ‘aave’ |
| LIQUIDATOR | TEXT | The address that performed the liquidation. Example: ‘0xabcdefabcdefabcdefabcdefabcdefabcdefabcd’ |
| BORROWER | TEXT | The address that initiated a borrow or repayment transaction. Example: ‘0x1234567890123456789012345678901234567890’ |
| PROTOCOL_MARKET | TEXT | The lending protocol’s receipt token issued to depositors. Example: ‘0xfedcbafedcbafedcbafedcbafedcbafedcbafed’ |
| COLLATERAL_TOKEN | TEXT | The token contract address used as collateral in a liquidation. Example: ‘0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2’ |
| COLLATERAL_TOKEN_SYMBOL | TEXT | The symbol of the asset used as collateral in liquidations. Example: ‘WETH’ |
| LIQUIDATED_AMOUNT_UNADJ | FLOAT | LIQUIDATED_AMOUNT_UNADJ column |
| LIQUIDATED_AMOUNT | FLOAT | LIQUIDATED_AMOUNT column |
| LIQUIDATED_AMOUNT_USD | FLOAT | LIQUIDATED_AMOUNT_USD column |
| AMOUNT_UNADJ | FLOAT | The raw amount of tokens liquidated without decimal adjustment. This column will be deprecated October 13th, please update to liquidatedamountunadj. |
| AMOUNT | FLOAT | The decimal-adjusted amount of tokens liquidated. This column will be deprecated October 13th, please update to liquidated_amount. |
| AMOUNT_USD | FLOAT | The USD value of the tokens liquidated. This column will be deprecated October 13th, please update to liquidatedamountusd. |
| DEBT_TOKEN | TEXT | The token contract address that was borrowed and is being repaid in liquidation. Example: ‘0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48’ |
| DEBT_TOKEN_SYMBOL | TEXT | The symbol of the borrowed asset being repaid in liquidation. Example: ‘USDC’ |
| REPAID_AMOUNT_UNADJ | NUMBER | REPAID_AMOUNT_UNADJ column |
| REPAID_AMOUNT | FLOAT | REPAID_AMOUNT column |
| REPAID_AMOUNT_USD | FLOAT | REPAID_AMOUNT_USD column |
| EZ_LENDING_LIQUIDATIONS_ID | TEXT | EZ_LENDING_LIQUIDATIONS_ID column |
| 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: |