Balances
ERC20 Balances
Block-level balance changes erc20 tokens across all addresses.
The ERC20 Balances table contains block-level balance changes of ERC20 tokens.
Each entry in the model corresponds to a specific event/transaction that causes a balance change in a particular asset at the block level.
This means a new data entry is only created when there is a transaction that alters token’s balance at the block level.
For example, if a wallet receives 10 USDC in 2020 and experiences no further changes until yesterday, the model will have two entries: one for the initial receipt in 2020 and another for the recent change.
Table Columns
Unique Key:unique_id
| Column Name | Data Type | Description |
|---|---|---|
| token_type | VARCHAR | Identifies whether the balance record is for a native or erc20 token |
| address | VARCHAR | The wallet address holding the tokens |
| token_address | VARCHAR | Contract address of the token |
| token_name | VARCHAR | Name of the token |
| token_symbol | VARCHAR | Symbol of the token |
| raw_balance_str | VARCHAR | Token balance, unnormalized, as string to retain precision |
| raw_balance | FLOAT | Token balance, unnormalized |
| balance_str | VARCHAR | Token balance as string to retain precision |
| balance | FLOAT | Token balance, normalized |
| usd_balance | FLOAT | Token balance, normalized, in USD |
| usd_exchange_rate | FLOAT | Exchange rate used for USD conversion |
| block_timestamp | TIMESTAMP_NTZ(9) | Timestamp of the block |
| block_number | BIGINT | Number of the block |
| block_hash | VARCHAR | Hash of the block |
| unique_id | VARCHAR | Unique identifier combining block, address, token address |
| _created_at | TIMESTAMP_NTZ(9) | Timestamp of when the entry was created |
| _updated_at | TIMESTAMP_NTZ(9) | Timestamp of when the entry was last updated |