Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
LABS
Guides

Setting Up Wallet Segmentation for Targeted Growth Strategies

A technical guide on segmenting protocol users by on-chain behavior using SQL queries and subgraphs to inform growth, incentives, and product development.
Chainscore © 2026
introduction
INTRODUCTION

Setting Up Wallet Segmentation for Targeted Growth Strategies

Wallet segmentation is a foundational strategy for analyzing and engaging on-chain communities by categorizing wallets based on their behavioral patterns and holdings.

In Web3, a wallet is more than a keypair; it's a persistent, pseudonymous identity with a rich transaction history. Wallet segmentation is the process of grouping these identities into cohorts based on shared characteristics like transaction volume, asset composition, or protocol interaction frequency. This moves beyond viewing users as a monolithic group, enabling teams to identify power users, dormant holders, or high-value prospects. For example, segmenting by total_transaction_count and total_volume_eth can separate casual traders from institutional whales.

Effective segmentation requires access to granular, historical on-chain data. Services like Chainscore aggregate and structure raw blockchain data into queryable datasets, making it possible to filter wallets by dozens of attributes. Common segmentation criteria include: - Holding Patterns: Wallets holding a specific NFT or token for >90 days. - Activity Level: Wallets with >50 transactions in the last 30 days. - Financial Tier: Wallets with a total portfolio value above 10 ETH. - Protocol Affinity: Wallets that primarily use Uniswap v3 or Aave.

Once segmented, these cohorts become actionable. A project can design targeted campaigns: airdropping governance tokens to loyal holders, offering early access to active traders, or providing educational content to new wallets. This precision improves capital efficiency and user satisfaction compared to broad, untargeted initiatives. The key is to define segments that align with specific business goals, such as boosting protocol revenue or increasing governance participation.

Implementing segmentation starts with defining your objectives and selecting the right data provider. Using the Chainscore API, you can programmatically fetch wallets that match your criteria. For instance, to find high-value DeFi users, you might query for wallets with significant deposits in major lending protocols. This data can then be exported to CRM platforms or used to generate allowlists for on-chain interactions via smart contracts.

The strategic power of segmentation lies in its iterative nature. By monitoring how different segments respond to initiatives—tracking metrics like retention rate or secondary sales—teams can refine their criteria and tactics. This creates a data-driven feedback loop for sustainable growth, turning anonymous wallet addresses into a understood and engageable community.

prerequisites
FOUNDATIONS

Prerequisites

Essential setup and core concepts required to implement wallet segmentation for on-chain growth.

Wallet segmentation is the practice of categorizing blockchain addresses based on on-chain behavior, asset holdings, and transaction history. Before building targeted strategies, you need the foundational tools to read and analyze this data. This requires a blockchain data provider like Chainscore, Alchemy, or The Graph, and a basic understanding of EVM-based wallets (e.g., MetaMask) and their public address format (0x...). Your first step is to obtain an API key from your chosen provider to query on-chain data programmatically.

You will need a development environment capable of making HTTP requests and processing JSON responses. A simple Node.js script using the axios or fetch library is sufficient for most analysis tasks. For example, to fetch basic wallet data from an RPC provider, you would call the eth_getBalance method. More advanced segmentation, however, relies on querying for specific event logs (like ERC-20 transfers) and analyzing transaction patterns over time, which is where specialized data platforms provide significant advantage.

Understanding key metrics is crucial for defining segments. Common segmentation vectors include: - Transaction Volume & Frequency: High vs. low activity wallets. - Asset Composition: Wallets holding specific NFTs or token balances above a threshold. - Protocol Interaction: Wallets that have interacted with a particular DeFi dApp or smart contract. - On-chain Age: Newly created wallets versus established "whale" addresses. These vectors form the basis of your targeting logic.

Finally, ensure you have a clear goal for your segmentation. Are you aiming to airdrop to loyal users, identify potential liquidity providers, or target users of a competitor's protocol? Your objective determines which data points are relevant. With your API access, development setup, and target metrics defined, you are ready to start querying the blockchain and building actionable wallet cohorts for your growth campaigns.

key-concepts
FOUNDATIONS

Key Concepts for Wallet Segmentation

Wallet segmentation is the process of categorizing blockchain addresses based on on-chain activity to inform growth, security, and product decisions. These concepts provide the analytical framework.

01

On-Chain Identity Graphs

An on-chain identity graph links multiple wallet addresses to a single entity or user. This is foundational for accurate segmentation.

  • Techniques include: analyzing funding sources (centralized exchange deposits), common transaction counterparties, and shared contract interactions.
  • Purpose: Prevents double-counting users and reveals the true scale of a protocol's user base.
  • Example: A user interacting with Uniswap via Wallet A and an NFT marketplace via Wallet B can be identified as one entity if both wallets were funded from the same Coinbase address.
02

Behavioral Clustering

This involves grouping wallets based on transaction patterns, not just balances. It moves beyond simple "whale" labels.

  • Common clusters: High-frequency traders, long-term stakers, NFT collectors, governance participants, and airdrop farmers.
  • Data points: Transaction volume, frequency, interacted dApp categories, time between actions, and gas spending patterns.
  • Use case: A DeFi protocol can target "high-frequency swappers" with liquidity mining incentives while offering "long-term lockers" enhanced governance rights.
04

Temporal Analysis & Cohort Tracking

Analyzing how wallet behavior changes over time and tracking groups of users who started using a product simultaneously.

  • Cohort Analysis: Segments users by their first interaction date (e.g., "Q1 2024 adopters") to measure retention and lifetime value.
  • Temporal Signals: Identifying wallets that become inactive, shift from testing to regular use, or suddenly increase transaction volume.
  • Actionable Insight: A protocol can identify that "cohorts from Q3 2023" have a 40% higher 90-day retention rate when they perform a governance vote within their first week.
05

Cross-Chain Attribution

Tracking a user's activity and identity across multiple blockchain networks (Ethereum, Arbitrum, Polygon, etc.).

  • Challenge: A user's activity is fragmented across chains where they use different addresses.
  • Solutions: Using bridging transaction patterns, cross-chain messaging protocols (like LayerZero, Axelar), and identity services that operate multichain.
  • Importance: Essential for protocols with multichain deployments to understand total user engagement and avoid subsidizing the same user on multiple chains.
06

Intent-Based Segmentation

Classifying wallets based on the inferred goal of their transactions, rather than just the assets held or actions taken.

  • Intent Signals: A wallet that consistently swaps to stablecoins after yield farming rewards may signal capital preservation. A wallet that provides liquidity only during high-fee periods signals MEV/arbitrage seeking.
  • Data Sources: Transaction sequence analysis, profit-taking patterns, and response to specific protocol events (e.g., governance proposals).
  • Strategic Use: A protocol can tailor its communication and incentive structures to align with these underlying user intents for better engagement.
data-sources
IDENTIFYING DATA SOURCES

Setting Up Wallet Segmentation for Targeted Growth Strategies

Effective wallet segmentation begins with aggregating and analyzing on-chain data to identify distinct user cohorts based on behavior, assets, and interactions.

The foundation of any wallet segmentation strategy is sourcing high-fidelity on-chain data. This involves querying blockchain data from providers like The Graph for indexed historical data, Alchemy or Infura for real-time RPC calls, and Dune Analytics or Flipside Crypto for pre-built community dashboards. For a targeted analysis, you might start by pulling all transaction histories for wallets that interacted with your protocol's smart contract over a specific timeframe. This raw data includes transaction hashes, timestamps, gas fees, function calls, and token transfers, forming the base layer for your segmentation model.

Once raw data is collected, the next step is feature engineering to create meaningful segmentation variables. Key features to extract include: wallet_age, total_transaction_volume, asset_holdings (e.g., specific NFT collections or governance tokens), protocol_interaction_frequency, and cross-chain activity. For example, you can use the Etherscan API or a library like ethers.js to calculate a wallet's first transaction date. Segmenting users into cohorts like "High-Volume Liquidity Providers," "Governance Participants," or "New User Airdrop Claimants" requires transforming raw logs into these behavioral and financial signals.

To operationalize this, you can write scripts using Python with web3.py or JavaScript with ethers.js. A basic query to identify wallets holding a specific ERC-20 token might look like: const holders = await contract.queryFilter(filterTransferEvent, fromBlock, toBlock);. For more complex segmentation, consider using a dedicated analytics platform like Nansen or Arkham which offer labeled wallet data (e.g., "Smart Money," "CEX Deposit"), saving significant engineering time but at a cost. The choice between building in-house or buying data depends on your need for customization, data freshness, and budget.

After defining your segments, validate the data by checking for completeness and accuracy. Ensure your queries account for wallet abstraction (like ERC-4337 smart accounts) and layer-2 solutions, where activity may be recorded on a separate chain. A common pitfall is overlooking wallets that use multiple addresses via deployer contracts or custodial solutions. Cross-reference your segmented lists with on-chain footprints to confirm behavioral patterns are consistent. This validation step is crucial before deploying any growth initiative based on these cohorts.

Finally, integrate your segmented wallet lists into your growth tools. Export addresses to CSV for use in Sybil-resistant airdrops, upload them as custom audiences in marketing platforms like Guild or Collab.Land for token-gated experiences, or use them as input for on-chain automation with Gelato Network or Defender Autotasks. For instance, you could automatically send a reward in USDC to all wallets in the "High-Engagement" segment that performed a specific action last month. The goal is to move from static analysis to dynamic, actionable strategies that drive targeted user retention and protocol growth.

SEGMENTATION CRITERIA

Common Wallet Segment Definitions

Key behavioral and on-chain attributes used to categorize wallet addresses for targeted engagement strategies.

Segment AttributeWhale / High-ValueActive DeFi UserNFT CollectorNew / Dormant

Total Portfolio Value (USD)

$1M

$10k - $1M

Varies, often >$50k

<$1k or unknown

Transaction Frequency

Low volume, high value

10 tx/week

Moderate, event-driven

<1 tx/month

Primary Activity

Governance, staking

Yield farming, swapping

Minting, bidding, trading

Holding, infrequent transfers

Protocol Diversity

High (5+ protocols)

Very High (10+ protocols)

Medium (focused on NFT platforms)

Low (1-2 protocols)

Holding Period

Long-term (>1 year)

Short to medium-term

Varies by collection

Unknown or long-term

Gas Fee Tolerance

High (>$100 per tx)

Medium ($10-$50 per tx)

High for mints/drops

Very Low (<$5 per tx)

Preferred Chains

Ethereum, Arbitrum, Solana

Arbitrum, Base, Polygon, Ethereum

Ethereum, Solana, Bitcoin (Ordinals)

Single chain, often Ethereum L1

PRACTICAL GUIDES

Implementation Examples by Platform

Using MetaMask and WalletConnect

For Ethereum and EVM-compatible chains like Polygon and Arbitrum, MetaMask is the standard for implementing segmentation. Use its eth_requestAccounts method to connect and the eth_accounts method to get the user's address for on-chain analysis.

Key Implementation Steps:

  1. Integrate WalletConnect v2 for dApp browser compatibility.
  2. Use the connected address to query on-chain data via providers like Alchemy or Infura.
  3. Segment users based on on-chain activity (e.g., NFT holdings, DeFi interactions) using the Moralis or Covalent APIs.
javascript
// Example: Connect and fetch basic wallet data
const accounts = await window.ethereum.request({ 
  method: 'eth_requestAccounts' 
});
const userAddress = accounts[0];
// Now query an API for wallet segmentation data
const nftData = await fetch(`https://deep-index.moralis.io/api/v2/${userAddress}/nft?chain=eth&format=decimal`);

This approach allows you to tailor UI/UX or airdrop campaigns based on proven on-chain behavior.

analysis-application
ANALYZING AND APPLYING SEGMENTS

Setting Up Wallet Segmentation for Targeted Growth Strategies

Wallet segmentation is a foundational Web3 growth technique that categorizes users by on-chain behavior to enable precise, data-driven engagement.

Wallet segmentation moves beyond viewing users as a monolithic group. By analyzing on-chain data, you can categorize wallets into distinct cohorts based on shared characteristics. Common segmentation criteria include transaction volume, asset holdings (e.g., NFT collections, token types), protocol interaction history, and wallet age. This process transforms raw blockchain data into actionable insights, allowing you to identify your most valuable users, understand different engagement patterns, and tailor your strategies accordingly. Tools like Dune Analytics, Flipside Crypto, and Nansen are essential for building these initial behavioral segments.

To implement segmentation, you first need to define your key metrics and data sources. Start by querying a blockchain indexer or using a pre-built dashboard to extract wallet lists. For example, a basic SQL query on Flipside might identify wallets that have interacted with your protocol more than five times in the last month. You can then enrich this data by joining tables to see what other DeFi protocols those wallets use or what NFTs they hold. This enrichment step is crucial for creating multi-dimensional segments like "High-Volume DeFi Degens" or "Blue-Chip NFT Collectors," which are more predictive than single-metric groups.

Once segments are defined, the next step is integration and activation. Export your wallet address lists for use in marketing and growth tools. Platforms like Crypto.com's DeFi Wallet API, Web3 CRM tools (e.g., Spatial, Kresus), or custom smart contracts can use these lists for targeted airdrops, token-gated experiences, or personalized on-chain messaging. For developers, a simple merkle tree implementation can efficiently verify segment membership on-chain for gas-efficient airdrops. Always ensure you have a clear value proposition for each segment; rewarding loyal users differs from re-engaging dormant ones.

Effective segmentation requires continuous analysis and iteration. Monitor how different segments respond to your campaigns by tracking on-chain conversion rates, retention metrics, and lifetime value (LTV). A/B test different reward structures or messaging for sub-segments. Be mindful of privacy considerations and avoid overly invasive tracking. The goal is to build a positive feedback loop: data informs segmentation, segmentation enables targeted action, and the results of those actions generate new data to refine your segments further, creating a scalable system for sustainable protocol growth.

WALLET SEGMENTATION

Frequently Asked Questions

Common questions and troubleshooting for developers implementing wallet segmentation to analyze and target on-chain user growth.

Wallet segmentation is the process of categorizing blockchain wallets into distinct groups based on their on-chain behavior, asset holdings, and transaction history. It's a core growth strategy because it allows projects to move beyond vanity metrics like total wallets and understand their actual user base.

Key segments include:

  • Power Users: High-frequency traders, liquidity providers, governance participants.
  • New Users: First-time interactors, often identified by recent creation or simple token transfers.
  • Whales: Wallets holding large amounts of specific tokens or NFTs.
  • Dormant Users: Previously active wallets with no recent transactions.

By analyzing these segments, teams can tailor incentives, airdrops, and communication strategies. For example, you might offer gas rebates to power users while providing educational content to new users, leading to more efficient capital allocation and higher retention rates.

conclusion
IMPLEMENTATION SUMMARY

Conclusion and Next Steps

You have now configured a secure, multi-wallet architecture for managing assets, executing transactions, and isolating risk. This guide covered the core principles and setup.

The wallet segmentation strategy you've implemented creates a robust operational framework. Your hot wallet handles daily interactions with dApps and DeFi protocols. Your cold storage vault secures long-term holdings offline. Your dedicated transaction wallet manages gas fees and batch operations, while your testing wallet allows for safe experimentation on testnets or with new contracts. This separation minimizes the blast radius of any potential compromise and streamlines your workflow.

To operationalize this setup, consider automating routine tasks. Use wallet automation tools like Gelato Network or OpenZeppelin Defender to schedule transactions from your transaction wallet. Implement multi-signature security for your cold vault using Safe (formerly Gnosis Safe) to require multiple approvals for large withdrawals. For developers, integrate WalletConnect or Web3Modal to allow your hot wallet to connect seamlessly to applications while keeping private keys isolated.

Your next step is to establish clear governance rules. Define transaction limits for each wallet category and set up monitoring alerts using services like Tenderly or Blocknative for anomalous activity. Regularly audit wallet permissions on sites like revoke.cash to revoke unnecessary token approvals. For teams, document a clear SOP (Standard Operating Procedure) outlining which wallet to use for specific actions like deploying contracts, providing liquidity, or claiming rewards.

Continue your education by exploring advanced custody solutions. Research MPC (Multi-Party Computation) wallets like Fireblocks or Coinbase WaaS for institutional-grade key management. Study account abstraction (ERC-4337) through providers like Stackup or Alchemy to enable social recovery and sponsored transactions. The goal is to evolve your setup from manual segmentation to a programmable, policy-driven asset management system.

Finally, stay updated on security practices. Bookmark resources like the Ethereum Foundation Security page and Immunefi's bug bounty reports. The landscape of wallet technology and attack vectors evolves rapidly; proactive learning is your best defense. By treating wallet management as a critical, evolving component of your stack, you build a foundation for secure and scalable growth in Web3.

How to Segment Wallets for Targeted Web3 Growth | ChainScore Guides