DeadRareDocs
Open app

Rarity Scores

How DeadRare calculates a standardised rarity score.

DeadRare calculates rarity with a single, standardised formula so that rankings stay consistent across every collection on the site. This page explains how a rarity score is produced and how project owners can fine‑tune it.

The rarity score

DeadRare reads a collection's metadata from the Alephium API and scores each NFT by summing the inverse of each trait's rarity, then scaling the result:

score = ( 1/x₁ + 1/x₂ + … + 1/xₙ ) × 100

where xᵢ is the percentage of the collection that shares trait i. Rarer traits (smaller percentages) contribute more to the score. An NFT's rank is simply its position when the whole collection is sorted by score, highest first.

Worked example

Take an NFT with seven traits occurring in 100%, 6.5%, 11%, 42%, 0.93%, 1.9% and 99% of the collection:

score = ( 1/100 + 1/6.5 + 1/11 + 1/42 + 1/0.93 + 1/1.9 + 1/99 ) × 100
score ≈ 191

The 0.93% trait dominates the score, exactly as you'd expect — it's the rarest attribute this NFT holds.

Rarity weightings

Project owners can change how much a given layer contributes, using a per‑layer weight that multiplies that layer's score:

score = ( l₁/x₁ + l₂/x₂ + … + lₙ/xₙ ) × 100

By default every weight lᵢ is 1. If, say, you wanted a "special" layer to matter more, you could raise its weight to 3:

score = ( 1/100 + 1/6.5 + 1/11 + 1/42 + 1/0.93 + 1/1.9 + 3/99 ) × 100

That layer now counts three times as much toward the final score. Owners can set any real number as a weight, but individual trait values cannot be changed — only the significance of a layer.

Rarities during a mint

While a collection is still minting, rankings reflect only the NFTs in circulation at that moment — the rarest minted so far. As minting continues and the pool grows, rarer and more common traits appear, so rankings naturally shift until the collection is fully minted.