Active Addresses vs Active Users in On-Chain Analytics
Define active-address metrics without equating addresses to people, and expose action filters, time windows and contract-account treatment.
Overview
When translating these concepts into an integration, keep the scope described by the wallet history api with the result. The examples in wallet transaction history and smart contract event logs show how the same distinction affects neighbouring data questions.
An active-address count is an address-based metric under a chosen activity rule. It does not directly count people. The result can change dramatically when the qualifying action changes.
Specify activity before counting
Decide whether activity means sending a transaction, receiving a token, interacting with a contract or another predicate. Record network, window and excluded evidence. One person can use many addresses, while custody or contract accounts can represent many users. Avoid presenting a de-duplicated address count as a verified customer population.
Worked example: passive recipients
A distribution sends tokens to one thousand addresses. A recipient-based metric counts them as active even if none initiated a transaction. A sender-based metric may count only the distributing account. Both can be computed correctly, but neither should be called one thousand engaged users without further evidence.
Publish comparable definitions
Keep the predicate and rule version with the series. Test spam, automated contracts and changed wallet infrastructure. Compare metrics only when windows and filters align. Show supporting counts, such as initiating accounts and passive recipients, so readers can understand what drove a change instead of attributing every increase to adoption.
A practical acceptance test
Provide one distributing address and one thousand passive recipients. Compare sender-based and recipient-based activity counts and retain both definitions. The application must not call either result a verified person count. Add a contract account and several addresses controlled by one hypothetical actor to ensure the metric does not silently infer identity relationships.
Questions about the topic
Frequently asked questions
Is one active address one active person?
No. Address and person identities are different.
Can receiving a token count as activity?
Only under a declared recipient-based definition.
Standards & technical documentation
