Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions features/wallet-intelligence/wallet-labels.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,13 @@
<img src="/images/wallet-intelligence-wallet-labels.png" alt="Wallet Labels" />
</Frame>

**Wallet Labels** annotate blockchain addresses with attributes like verification status, lifecycle stage, and reputation scores.

Check warning on line 10 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L10

Did you really mean 'blockchain'?

Use labels to build [segments](/features/wallet-intelligence/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.

Check warning on line 16 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L16

Use 'formo' instead of 'Formo'.

### User lifecycle labels

Expand All @@ -23,20 +23,30 @@

| Label | Description |
|-------|-------------|
| **OFAC Sanctioned** | OFAC-sanction status, sourced from Chainalysis's onchain sanctions oracle |

Check warning on line 26 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L26

Did you really mean 'Chainalysis's'?
| **Human Passport Unique Humanity Score** | [Human Passport score (0-100)](https://docs.passport.xyz/) |
| **Human Passport Aggregate Model Score** | [Aggregate unique humanity score for EVM wallets (0-100, or -1 if there's insufficient transaction history)](https://docs.passport.xyz/building-with-passport/models/available-models#aggregate-unique-humanity-model) |
| **Coinbase Verified Account** | [Coinbase verified account attestations](https://www.coinbase.com/developer-platform/products/verifications) |

Check warning on line 29 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L29

Did you really mean 'Coinbase'?

Check warning on line 29 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L29

Did you really mean 'Coinbase'?
| **Coinbase Verified Country** | Coinbase verified country attestations with country code extraction |

Check warning on line 30 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L30

Did you really mean 'Coinbase'?

Check warning on line 30 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L30

Did you really mean 'Coinbase'?
| **Coinbase One** | Coinbase One subscription attestations |

Check warning on line 31 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L31

Did you really mean 'Coinbase'?

Check warning on line 31 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L31

Did you really mean 'Coinbase'?
| **Binance Verified** | Holds a [Binance Account Bound Token (BABT)](https://www.binance.com/en/babt), attesting the wallet completed Binance KYC |

Check warning on line 32 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L32

Did you really mean 'Binance'?

Check warning on line 32 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L32

Did you really mean 'Binance'?

Check warning on line 32 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L32

Did you really mean 'Binance'?

### Sybil

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

Check warning on line 36 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L36

Did you really mean 'sybil'?

| Label | Description |
|-------|-------------|
| **Sybil (LayerZero)** | Named in the [LayerZero airdrop sybil list](https://github.com/psrvere/layerzero-sybil-checker) as a suspected airdrop farmer |

Check warning on line 40 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L40

Did you really mean 'sybil'?
| **Sybil (Hop)** | Listed as a sybil attacker in the [Hop Protocol airdrop](https://github.com/hop-protocol/hop-airdrop/blob/master/src/data/eliminatedSybilAttackers.csv) |

Check warning on line 41 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L41

Did you really mean 'sybil'?
| **Sybil (Optimism)** | Removed from the [Optimism airdrop](https://community.optimism.io/citizens-house/airdrops/airdrop-1) for sybil activity |

Check warning on line 42 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L42

Did you really mean 'sybil'?

### Others

| Label | Description |
|-------|-------------|
| **Merkl Campaigns** | Tracks participation in [Merkl](https://merkl.xyz) incentive campaigns. Formo automatically detects campaign IDs from the Merkl API and stores them as a label on the wallet profile. You can filter users by campaign ID to measure the quality of users acquired through specific Merkl campaigns. |

Check warning on line 48 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L48

Did you really mean 'Merkl'?

Check warning on line 48 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L48

Did you really mean 'Merkl'?

Check warning on line 48 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L48

Use 'formo' instead of 'Formo'.

Check warning on line 48 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L48

Did you really mean 'Merkl'?

Check warning on line 48 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L48

Did you really mean 'Merkl'?
| **ERC-8004 AI Agent** | Automatically detects wallets registered as AI agents via the [ERC-8004](https://erc8004.org) standard. Formo queries onchain registries across 11 chains to identify agent wallets (agent discovery runs via subgraph on 5 of them; the rest are used for RPC and reputation lookups once an agent is found) and surfaces the agent name, ID, and reputation score on the wallet profile. |

Check warning on line 49 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L49

Use 'formo' instead of 'Formo'.

Check warning on line 49 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L49

Did you really mean 'subgraph'?

Check warning on line 49 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L49

Did you really mean 'lookups'?

---

Expand All @@ -46,12 +56,13 @@

### 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.

Check warning on line 59 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L59

Use 'formo' instead of 'Formo'.

Check warning on line 59 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L59

Use 'formo' instead of 'Formo'.

**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

Check warning on line 63 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L63

Did you really mean 'Coinbase'?

Check warning on line 63 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L63

Did you really mean 'Binance'?
- **Sybil lists** - Membership in published airdrop sybil / farmer lists (LayerZero, Hop, Optimism)

Check warning on line 64 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L64

Did you really mean 'sybil'?
- **Campaigns** - Participation in incentive campaigns such as Merkl

Check warning on line 65 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L65

Did you really mean 'Merkl'?
- **Onchain registries** - Standards such as ERC-8004 that identify AI agent wallets
- **Custom** - Labels you add manually to a wallet's profile

Expand Down Expand Up @@ -79,7 +90,7 @@
| Find power users | Lifecycle = "Power user" |
| Find verified humans | Human Passport Score > 50 |
| Exclude sanctioned wallets | Label != "OFAC Sanctioned" |
| Find Coinbase users | Label = "Coinbase Verified Account" |

Check warning on line 93 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L93

Did you really mean 'Coinbase'?

Check warning on line 93 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L93

Did you really mean 'Coinbase'?

### Step 3: Combine labels with other filters

Expand All @@ -88,14 +99,14 @@
**High-value DeFi users:**
| Filter | Value |
|--------|-------|
| Apps | Uniswap, Aave (or other DeFi protocols) |

Check warning on line 102 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L102

Did you really mean 'Aave'?
| Net Worth | > $50,000 |
| Lifecycle | Power user |

**Verified users from campaigns:**
| Filter | Value |
|--------|-------|
| Label | Coinbase Verified Account |

Check warning on line 109 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L109

Did you really mean 'Coinbase'?
| UTM Source | twitter |
| First Seen | Last 30 days |

Expand Down Expand Up @@ -124,11 +135,11 @@

**Compliance filtering:**
1. Filter by Label != "OFAC Sanctioned"
2. Add Human Passport Score > 20 for sybil resistance

Check warning on line 138 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L138

Did you really mean 'sybil'?
3. Export clean lists for marketing or rewards

**Quality scoring:**
1. Combine multiple positive labels (Power user + Coinbase Verified Account + Human Passport Score > 50)

Check warning on line 142 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L142

Did you really mean 'Coinbase'?
2. Users matching more labels = higher quality
3. Prioritize multi-label users for outreach

Expand All @@ -143,5 +154,5 @@

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

Check warning on line 157 in features/wallet-intelligence/wallet-labels.mdx

View check run for this annotation

Mintlify / Mintlify Validation (formo) - vale-spellcheck

features/wallet-intelligence/wallet-labels.mdx#L157

Did you really mean 'net_worth_usd'?
4. Get notified within 5 minutes when a wallet matching those filters becomes active