Skip to main content

Table description

The balances table (e.g. polkadot.balances) stores a snapshot of all account balances at the end of each day: free, reserved, misc_frozen, and their USD value, if available.

Table Schema

ColumnTypeDescription
yearINTEGERCalendar year of the snapshot (partition column)
monthINTEGERCalendar month of the snapshot (partition column)
dayINTEGERCalendar day of the snapshot (partition column)
tsTIMESTAMPTimestamp of the end-of-day balance snapshot
symbolVARCHARToken symbol (e.g. DOT, KSM)
address_ss58VARCHARSS58-encoded address of the account holder
address_pubkeyVARBINARYPublic key of the account holder
idVARCHARUnique identifier for the asset
chain_nameVARCHARName of the Substrate chain (e.g. polkadot, kusama)
assetVARCHARAsset type or name
para_idBIGINTParachain ID, if the balance is on a parachain
freeDOUBLEFreely transferable balance (human-readable units)
reservedDOUBLEReserved balance locked for on-chain activities (human-readable units)
misc_frozenDOUBLEBalance frozen for miscellaneous reasons (human-readable units)
frozenDOUBLETotal frozen balance (human-readable units)
nonceBIGINTAccount transaction nonce at the time of the snapshot
free_rawVARCHARRaw free balance in smallest denomination (Planck)
reserved_rawVARCHARRaw reserved balance in smallest denomination (Planck)
misc_frozen_rawVARCHARRaw misc frozen balance in smallest denomination (Planck)
frozen_rawVARCHARRaw frozen balance in smallest denomination (Planck)
flags_rawVARCHARRaw account flags value
updated_atTIMESTAMPWhen this record was last updated in the database
ingested_atTIMESTAMPWhen this record was first ingested into the database

Table Sample