Skip to main content
Wallet Labels

Enrich user profiles with wallet labels.

Wallet Labels annotate blockchain addresses with attributes like verification status, lifecycle stage, and reputation scores. Use labels to build segments that target users matching your Ideal Customer Profile (ICP).

List of Labels

Each tracked user on Formo is assigned labels based on their onchain activity and other data.

User lifecycle labels

Every wallet is assigned a lifecycle stage based on its recency and active days: New, Returning, Power user, At Risk, Churned, or Resurrected. See User lifecycle for the exact rules and thresholds.

Attestations

Sybil

Wallets that appear on published airdrop sybil / farmer lists. These are one-time historical snapshots from past airdrop investigations, so a wallet is labeled only if it was named in the original list.

Behavioural labels

Behavioural labels computed from a wallet’s current onchain positions. Formo groups every protocol a wallet holds a position in into a category (lending, DEX, perps, staking, and so on) and applies one rule per label. Each label carries a value: the USD amount behind the label, which you can filter with >, >=, < and <=, or for the bridge and aggregator labels the names of the protocols the wallet used, which you can filter by protocol. Rules that apply to every label below:
  • Only positions from the wallet’s latest profile snapshot count. A position the wallet has closed never lingers.
  • Labels refresh daily and are removed automatically when the rule stops holding.
  • An active wallet is re-profiled every 30 days.

Others


How to use labels for targeting

This section covers using labels to identify and target specific user types.

How labels work

Formo automatically analyzes each wallet’s onchain activity and assigns relevant labels. Labels update as users’ behavior changes. You can also add your own custom labels to a wallet for information Formo can’t detect on its own. Label sources:
  • Lifecycle - Engagement stage derived from each wallet’s recency and active days
  • Attestations - Verified credentials from Coinbase, Binance, Human Passport, and OFAC sanction lists
  • Behavioural labels - What the wallet currently does onchain: lending, borrowing, liquidity provision, staking, perps, options, basis trading, real-world assets, bridges and aggregators
  • Sybil lists - Membership in published airdrop sybil / farmer lists (LayerZero, Hop, Optimism)
  • Campaigns - Participation in incentive campaigns such as Merkl
  • Onchain registries - Standards such as ERC-8004 that identify AI agent wallets
  • Custom - Labels you add manually to a wallet’s profile

Step 1: View labels on a user profile

  1. Go to Users and click any wallet address
  2. Open the Properties tab
  3. See all labels assigned to this user in the User Labels section
Auto-generated labels (lifecycle, attestations, campaigns, registries) are read-only. Click + Add Label to add, edit, or remove a custom label. To filter users by label, use Add Filter (see Step 2 below).

Step 2: Filter users by label

Use labels to find specific user types:
  1. Go to Users
  2. Click Add Filter
  3. Select Label as the filter type
  4. Choose the label(s) you want
Example filters:

Step 3: Combine labels with other filters

Combine labels with other filters to narrow further: High-value DeFi users: Verified users from campaigns: At-risk whales:

Step 4: Save as a segment

Turn useful label combinations into reusable segments:
  1. Apply your label + other filters
  2. Click Save Segment
  3. Name it descriptively (e.g., “Verified DeFi Whales”)
  4. Use the segment for analysis, exports, or alerts

Common targeting strategies

Identify your ICP (Ideal Customer Profile):
  1. Look at your best users (highest volume, most active)
  2. Check which labels they share
  3. Create a segment with those labels
  4. Use it to find similar users
Compliance filtering:
  1. Filter by Label != “OFAC Sanctioned”
  2. Add Human Passport Score > 20 for sybil resistance
  3. Export clean lists for marketing or rewards
Quality scoring:
  1. Combine multiple positive labels (Power user + Coinbase Verified Account + Human Passport Score > 50)
  2. Users matching more labels = higher quality
  3. Prioritize multi-label users for outreach
Competitive targeting:
  1. Use Apps filter to find users of competitor protocols
  2. Combine with labels showing high engagement
  3. Target these users with differentiated messaging

Label-based alerting

Set up alerts based on labels:
  1. Go to Settings > Alerts
  2. Create a User alert
  3. Add filters: Lifecycle = “Power user” AND net_worth_usd > 100000, or Labels = your target label
  4. Get notified within 5 minutes when a wallet matching those filters becomes active