In this track: Digital value and units
What does a token balance mean?
A number reported under a token contract’s rules, not a universal cash value.
A club’s register can say you have ten points. The number alone does not tell you what those points can buy or whether transfers are allowed.
1 ETH = 1000000000 Gwei = 1000000000000000000 Wei.
Ask which register you are reading
For a typical ERC-20 interface, balanceOf(address) reports a raw integer for that account. The result belongs to that token contract on that network. A token balance and the account’s native ETH balance are separate quantities.
A balance is not a price
A million raw units might display as one token or a tiny fraction, depending on decimals. Even after correct formatting, the number says nothing by itself about liquidity, exchange value or redemption rights.
Transfer rules can differ
Some token implementations pause transfers, charge fees, restrict accounts or change balances through special mechanisms. A familiar ERC-20 interface helps applications communicate; it does not guarantee every implementation has identical behavior.
Offline examples have a clear boundary
Our ABI tools can encode balanceOf and decode supplied bytes, but they do not query a contract. No displayed sample in the lab should be mistaken for an actual account’s current balance. Learn the distinction between reading network state and inspecting local data.
Does a token balance establish its market value?
A balance is a quantity. A market value needs additional economic information.
Original explanations by EtherTools. Examples are educational and source-linked; this site is independent of the Ethereum Foundation. Our approach.