Holder Labels
Per-token labels describing a wallet’s standing on a specific token — whether it’s an early holder, a top holder, a long-term holder, or not even a person but a pool. Distinct from the cross-mint behavior taxonomy on Labels & Taxonomy.
These holder labels aren’t yet exposed on a public endpoint. The label set is computed today and rides internally on the holder summary; the REST/stream surface below is on the roadmap. For now, the holder list endpoints return balances and firstSeenSlot without label enrichment.
Two different label planes
| Plane | Scope | Examples | Where |
|---|---|---|---|
| Holder labels (this page) | One wallet, one token | HOLDER:TOP_10, HOLDER:OG | per-mint holder state |
| Behavior taxonomy | One wallet, across all tokens | DAY_TRADER, RUNNER_KEEPER | Labels & Taxonomy |
A wallet can be a HOLDER:OG on one token and a PAPER_HANDS trader overall — the two planes answer different questions.
The label set
Each holder carries a labels array and a class.
labels — position labels for this token:
| Label | Meaning |
|---|---|
HOLDER:TOP_10 | Currently among the token’s 10 largest holders |
HOLDER:FIRST_100 | Was among the first 100 wallets to ever hold the token |
HOLDER:OG | Got in during the token’s earliest window |
HOLDER:LIFER | Has held continuously since very early |
CLASS:POOL:{dex} | The “holder” is a DEX pool / LP account, not a person (e.g. CLASS:POOL:Raydium) |
class — what kind of account this holder is:
| Value | Meaning |
|---|---|
human | An ordinary wallet |
pool | A DEX liquidity pool account |
curve | A bonding-curve account |
program_account | A program-owned account |
class is the filter you want when analyzing real holders — exclude pool / curve / program_account so a token’s liquidity pool doesn’t show up as its biggest “holder.” When this ships, the labels and class will be attached to each entry in the holder list and the holder streams.