Marketplace Guide

Learn how our marketplace features, algorithms, and metrics work.

Holder Tier Badges

Every holder in a collection's Holders panel is assigned a tier badge based on their relative weight in that collection. Tiers adapt automatically to any collection size using a dual-criteria algorithm.

Whale
Whale
≥ 5% supply
or Top 1% rank
Shark
Shark
≥ 2% supply
or Top 5% rank
Dolphin
Dolphin
≥ 0.5% supply
or Top 20% rank
Fish
Fish
Below all
thresholds

How Tiers Are Calculated

Each holder is evaluated by two independent checks. They receive whichever tier is higher:

Check A — Supply Share

The percentage of the collection's total supply held by the wallet.

TierThreshold
Whale≥ 5% of total supply
Shark≥ 2% of total supply
Dolphin≥ 0.5% of total supply
FishBelow 0.5%

Check B — Rank Percentile

The holder's position among all unique holders, sorted by quantity held. Minimum thresholds ensure tiers are meaningful even in small collections.

TierPercentileMinimum Position
WhaleTop 1%At least top 3
SharkTop 5%At least top 10
DolphinTop 20%At least top 25
FishBelow top 20%

Why Dual Criteria?

Small collections (50–200 holders) often have wallets holding a significant supply share but few absolute holders, so the supply check naturally dominates. Large collections (10,000+ holders) may have no single wallet above 0.5%, so the rank percentile check ensures the top holders are still recognized. The dual approach adapts automatically to any collection size without manual tuning.

Diamond Hands Tiers

A second icon in the holders panel classifies each holder by how long they've kept their NFTs. The algorithm uses a dual-criteria approach — the same pattern as whale tiers — evaluating both absolute hold time and relative position among holders.

Diamond
Diamond
≥ 365 days
or Top 5% duration
Rock
Rock
≥ 180 days
or Top 15% duration
Scissors
Scissors
≥ 90 days
or Top 40% duration
Paper
Paper
Below all
thresholds

How Hold Duration Is Calculated

For each holder, the system computes the average hold duration across all their NFTs in the collection. Each NFT's hold time is measured from when the current owner acquired it (the ownedSince timestamp). For staked NFTs, the staking start date is also considered — whichever is earlier is used, since staking is an even stronger commitment signal.

Check A — Absolute Hold Duration

The average number of days the holder has kept their NFTs.

TierThreshold
Diamond≥ 365 days (1 year)
Rock≥ 180 days (6 months)
Scissors≥ 90 days (3 months)
PaperBelow 90 days

Check B — Relative Percentile

The holder's position when all holders are ranked by average hold duration (longest first). Minimum thresholds ensure meaningful tiers in small collections.

TierPercentileMinimum Position
DiamondTop 5%At least top 3
RockTop 15%At least top 8
ScissorsTop 40%At least top 15
PaperBelow 40%

Staking Bonus

If an NFT is currently staked, the staking start date is compared with the ownership acquisition date. The earlier date is used, meaning holders who stake their NFTs get credit for the full duration of their commitment.

Data Accuracy

Hold duration tracking begins when the system is first deployed for a collection. All existing holders receive a baseline date, which improves naturally over time as NFTs are traded — new buyers receive fresh timestamps while long-term holders retain the oldest dates. The longer a collection is tracked, the more accurate the tier assignments become.