> ## Documentation Index
> Fetch the complete documentation index at: https://docs.formo.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet intelligence overview

> Explore wallet intelligence features including wallet profiles, audience insights, user segmentation, labels, and scoring for onchain user targeting.

<Frame caption="Get a complete view of your users.">
  <img src="https://mintcdn.com/formo/Qbe3dL6juMIXAS6y/images/users.png?fit=max&auto=format&n=Qbe3dL6juMIXAS6y&q=85&s=15e1905c31cbe5523c4b7216a738a0b3" alt="Users" width="2282" height="926" data-path="images/users.png" />
</Frame>

## Features

Wallet intelligence helps you **understand and target users with crypto-native segmentation based on unified offchain and onchain data**:

* 🔍 <a href="/features/wallet-intelligence/search">**Wallet search.**</a> Look up any wallet address to generate a full profile on demand.
* 🕵️‍♀️ <a href="/features/wallet-intelligence/wallet-profiles">**Wallet profiles.**</a> Turn wallet addresses into user profiles.
* 👥 <a href="/features/wallet-intelligence/audience-insights">**Audience insights.**</a> See your users' lifecycle, apps, tokens, chains, revenue, and retention.
* 🤩 <a href="/features/wallet-intelligence/segments">**User segments.**</a> Target segments based on wallet properties and in-app activity.
* 🏷️ <a href="/features/wallet-intelligence/wallet-labels">**Wallet labels.**</a> Further enrich wallet profiles with wallet labels.

Profile data is available for querying and export in the [Profiles API](/api/overview#profiles-api).

***

## How to explore your users

This guide walks you through viewing wallet profiles, understanding your audience, and creating your first user segment.

### Step 1: View the Users page

1. Open the [Formo Dashboard](https://app.formo.so)
2. Select your project from the sidebar
3. Click **Users** in the left navigation

You'll see a table of all users who have connected a wallet to your app, along with key metrics like net worth, lifecycle stage, and last seen.

<Frame caption="The Users page shows all wallets that have connected to your app.">
  <img src="https://mintcdn.com/formo/Qbe3dL6juMIXAS6y/images/users.png?fit=max&auto=format&n=Qbe3dL6juMIXAS6y&q=85&s=15e1905c31cbe5523c4b7216a738a0b3" alt="Users list" width="2282" height="926" data-path="images/users.png" />
</Frame>

### Step 2: Explore a wallet profile

Click on any wallet address to open its full profile. The wallet profile shows:

| Section | What you'll see |
| - | - |
| **Activity** | Real-time feed of actions on your app with UTM attribution |
| **Apps** | DeFi applications the wallet uses across chains |
| **Tokens** | Token balances and holdings across chains |
| **Properties** | Custom properties and labels. |

<Frame caption="View a user's DeFi positions and token balances across chains.">
  <img src="https://mintcdn.com/formo/N-uk5SnfJVeheQMa/images/screenshots/wallet-profile-activity.png?fit=max&auto=format&n=N-uk5SnfJVeheQMa&q=85&s=a1074cf9ad94c7e5f8efa784cc9a382b" alt="Wallet Profile" width="2418" height="1512" data-path="images/screenshots/wallet-profile-activity.png" />
</Frame>

### Step 3: Understand lifecycle stages

Formo automatically categorizes users by lifecycle stage based on their activity:

| Stage | What it means |
| - | - |
| **New** | Recent acquisition |
| **Returning** | Engaged user |
| **Power user** | Highly engaged |
| **At Risk** | Still active but going quiet |
| **Churned** | Needs re-engagement |
| **Resurrected** | Re-engaged after going quiet |

Use the lifecycle filter on the Users page to focus on specific user groups.

See [User Lifecycle](/features/wallet-intelligence/wallet-profiles#user-lifecycle) for the exact rules and thresholds behind each stage.

### Step 4: Create your first segment

Segments let you group users by shared characteristics. Here's how to create one:

1. Go to **Users** in the sidebar
2. Apply filter conditions. For example:
   * Lifecycle = "Power user"
   * Net worth > \$10,000
   * Label = "Coinbase Verified"
3. Click **Save Segment**
4. Name your segment (e.g., "High-Value Verified Users")
5. Click **Save**

Saved segments are managed inline on the Users page via the Segments dropdown.

<Frame caption="Create segments by combining wallet properties, lifecycle, and behavior.">
  <img src="https://mintcdn.com/formo/Qbe3dL6juMIXAS6y/images/wallet-intelligence-segments.png?fit=max&auto=format&n=Qbe3dL6juMIXAS6y&q=85&s=71fd0c1bc5e67c2b4019bab5065aad6d" alt="Segment builder" width="808" height="173" data-path="images/wallet-intelligence-segments.png" />
</Frame>

### Example: Find whales who churned

Here's a practical segment to identify high-value users at risk:

| Filter | Value |
| - | - |
| Lifecycle | Churned |
| Net worth | > \$100,000 |
| Last seen | > 30 days ago |

Export this segment as CSV to run targeted re-engagement campaigns on social channels.

## FAQ

<AccordionGroup>
  <Accordion title="Where does Formo get onchain data for wallet profiles?">
    Formo aggregates onchain data across major EVM chains and Solana to build wallet profiles. This includes token holdings, DeFi positions, wallet age, transaction frequency, and net worth. Data is refreshed periodically to keep profiles current.
  </Accordion>

  <Accordion title="How are wallet lifecycle stages determined?">
    Lifecycle stages are calculated from a wallet's activity recency and frequency on your app, relative to a reference date that defaults to today. Default thresholds can be customized in Settings → Lifecycle. See [User Lifecycle](/features/wallet-intelligence/wallet-profiles#user-lifecycle) for the exact rules.
  </Accordion>

  <Accordion title="Can I export wallet profiles and segments?">
    Yes. You can export any [segment](/features/wallet-intelligence/segments) as a CSV file for use in targeted re-engagement campaigns. You can also query profiles programmatically via the [Profiles API](/api/profiles/get).
  </Accordion>

  <Accordion title="Does Formo link multiple wallets belonging to the same user?">
    Yes. Formo automatically groups wallets that share a session or a common user ID into clusters. Each wallet's profile lists its **Linked Addresses**, and the **Clusters** tab on the Users page shows every multi-wallet group with its member wallets. You can also use [formo.identify()](/data/events/identify) to associate wallets with a common user ID.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.