Glossary: Wallet Clustering
Wallet clustering groups addresses that may be controlled by the same user or entity, using explicit links or behavioral signals. Clusters can help analyze activity, but they are not verified identities.
What is Wallet Clustering?
Wallet clustering associates addresses using explicit connections or inferred signals such as shared activity. The method, confidence, and possible shared-service addresses affect the result; a cluster should not be treated as verified personal identity.
How wallet clustering works
Strong signals include explicit account links, verified ownership, or wallets connected within an authenticated product context. Weaker behavioral or transaction patterns may support probabilistic relationships but should carry lower confidence. Embedded wallets, smart accounts, exchange deposit addresses, multisigs, and shared devices can complicate the one-wallet-one-user assumption.
Wallet clustering example
A user signs in to one product account and connects an EOA, an embedded wallet, and a smart account. The three addresses can be represented as one analytical cluster while each address retains its own transactions, balances, source, and confidence record. Reports can then switch between address-level and cluster-level counts.
Common mistakes
Do not treat every transfer between addresses as common ownership or present a probabilistic cluster as a verified person. Avoid irreversible merges, hidden confidence thresholds, and analysis that discards the original addresses. Clustering can introduce false positives, false negatives, bias, and privacy risk.
Using Wallet Clustering in practice
Use clustering when the analytical question requires user-level journeys, deduplicated activity, or related-wallet context. Keep address-level reporting available, document the method, and allow uncertain links to be reviewed or reversed. Apply the same clustering version when comparing periods or cohorts.
Related reading
Explore Identity Resolution, Wallet Profiles, Unique Active Wallets, and the wallet and web analytics guide.
FAQs
Is wallet clustering proof that addresses belong to one person?
No. A cluster is an analytical relationship supported by stated evidence and confidence, not automatic proof of real-world identity.
How do smart accounts affect wallet clustering?
One user may interact through owners, signers, session keys, or account contracts, so the cluster model must preserve those different roles.
Can wallet clusters change over time?
Yes. New evidence can add, remove, or revise links, so reports should record the clustering method and evaluation time.
The data platform onchain apps
Get actionable analytics and attribution for crypto and DeFi.
Stay up to date with weekly product updates and the latest industry insights.
Platform