Token holders

Overview

Token holders measures the number of unique addresses that hold a non-zero balance of a project’s native token. Investors use this metric to track the growth of the token’s holder base over time.

Data sources

• Blockchain state data and account balance snapshots
• On-chain events and program instructions capturing balance modifications
• Asset metadata for decimal normalization and chain identification
• End-of-day price feeds for USD conversion

Common calculation approaches

Snapshot-based balance tracking

Daily snapshots of account balances are extracted from blockchain state data to identify unique addresses with positive holdings. This method is utilized for networks including Ethereum and Tron, where end-of-day state records are used to verify the distribution of the native asset across all active addresses.

Transaction and instruction analysis

Token holder counts are reconstructed by analyzing balance changes generated by native transfers and contract interactions. For example, on Solana, program instructions are monitored to maintain a running record of addresses with non-zero balances, ensuring that only accounts with holdings exceeding network storage requirements are included.

UTXO-based state reconstruction

Address balances are determined by analyzing Unspent Transaction Outputs (UTXOs) from block records. This approach is applied to Bitcoin to identify the total number of unique addresses that maintain a positive balance based on the current set of unspent outputs.

Staked and liquid balance integration

Both liquid and staked token balances are combined to provide a comprehensive count of unique holders. This pattern is seen on NEAR Protocol, where balance modifications for both liquid accounts and staking validators are aggregated to ensure all participants with an economic interest are captured.

Note: The calculation approaches and protocol examples above are representative patterns. Individual protocol implementations may vary.