Skip to main content
Point-in-time snapshots of token balances for every address. Each row represents a balance snapshot at a specific block, capturing the raw token balance held by an address.

Table Columns

Unique Key: block_number, address, token_address
Column NameData TypeDescription
addressVARCHARThe wallet or contract address holding the token balance.
token_addressVARCHARThe contract address of the token, or the native token sentinel address.
raw_balanceVARCHARThe unnormalized token balance at this block, stored as a string to preserve precision.
block_numberNUMBER(38,0)The block number at which this balance snapshot was recorded.
block_timestampTIMESTAMP_NTZ(9)The timestamp of the block at which this balance snapshot was recorded.
block_hashVARCHARThe hash of the block at which this balance snapshot was recorded.
is_balance_changeBOOLEANWhether this snapshot was triggered by a balance-changing event in this block.
_metadataVARIANTInternal metadata from the balance ingestion pipeline.
_errorVARIANTError information if the balance fetch encountered an issue.
_sourceVARCHARThe data source or ingestion pipeline that produced this record.
_created_atTIMESTAMP_NTZ(9)Timestamp of when the entry was created in the database.
_updated_atTIMESTAMP_NTZ(9)Timestamp of when the entry was last updated in the database.