> ## 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 onchain with crypto-native segmentation**:

* 🔍 <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 pseudonymous wallets into actionable onchain personas.
* 👥 <a href="/features/wallet-intelligence/audience-insights">**Audience insights.**</a> Get comprehensive insights into your audience, including user lifecycle, apps, tokens, chains, revenue, and retention.
* 🤩 <a href="/features/wallet-intelligence/segments">**User segments.**</a> Use precise targeting on segments based on wallet properties, user lifecycle, and in-app activity.
* 🏷️ <a href="/features/wallet-intelligence/wallet-labels">**Wallet labels.**</a> Understand each user's preferences with autogenerated wallet labels.

Unify offchain and onchain data to build a complete picture of your users with Formo's wallet-native web3 CRM.

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.

<Note>Wallet Intelligence requires the Formo SDK to be installed. Complete the [Product Analytics setup](/features/product-analytics/overview) first if you haven't already.</Note>

### 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/wallet-intelligence-users.png?fit=max&auto=format&n=Qbe3dL6juMIXAS6y&q=85&s=f468315ac5e2ee6dfa7100cacfb53f34" alt="Users list" width="1101" height="446" data-path="images/wallet-intelligence-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                            |
| **Details**  | ENS name, net worth, lifecycle stage, 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               |
| **Resurrected** | Re-engaged after going quiet |
| **At Risk**     | Still active but going quiet |
| **Churned**     | Needs re-engagement          |

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 Account"
3. Click **Save as 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 transaction | > 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 all major EVM chains 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 calculated?">
    Wallet lifecycle stages (New, Returning, Power User, Resurrected, At Risk, Churned) are calculated based on activity recency and frequency on your app, relative to a reference date that defaults to today. For example, a wallet last seen more than 30 days ago is classified as "Churned," while a wallet first seen 30+ days ago and active on 5+ of the last 30 days is a "Power User." Default thresholds can be customized in Settings → Lifecycle. See [wallet profiles](/features/wallet-intelligence/wallet-profiles#user-lifecycle) for details.
  </Accordion>

  <Accordion title="Can I export wallet profiles and segments for marketing campaigns?">
    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?">
    Formo tracks each wallet address as a separate profile. If a user connects multiple wallets in the same session, those events are linked to the same anonymous visitor. You can also use [formo.identify()](/data/events/identify) to associate wallets with a common user ID.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Audience Insights" icon="users" href="/features/wallet-intelligence/audience-insights">
    Get aggregate analytics on your entire user base
  </Card>

  <Card title="Wallet Labels" icon="tags" href="/features/wallet-intelligence/wallet-labels">
    Understand auto-generated behavioral labels
  </Card>

  <Card title="User Segments" icon="users" href="/features/wallet-intelligence/segments">
    Create segments based on wallet properties and behavior
  </Card>

  <Card title="Profiles API" icon="code" href="/api/profiles/get">
    Query wallet profiles programmatically
  </Card>
</CardGroup>