First Ledger NFT
CreateChecking whether you are signed in

Rarity and traits

Traits are what an NFT’s metadata says about it, such as its background or its hat. Rarity is how uncommon those traits are within its collection. This guide explains both, and what neither can tell you.

Where traits come from

An NFT’s traits come from its metadata: the document its link points to, written by whoever created it. First Ledger reads that document and records each trait as a type and a value, such as Background and Gold.

Traits are shown exactly as the metadata writes them, and they are never translated. They are the creator’s words, and a translated trait would no longer match the filter it names.

Traits belong to their collection. A Background in one collection has nothing to do with a Background in another.

Until First Ledger has read an NFT’s metadata, the NFT has no traits here. A collection whose metadata has not been read yet shows no traits at all.

An attribute that gives a rank as a number, such as Ranking, is not shown as a trait. A rank is one NFT’s place in a list, not something other NFTs share. An attribute called Rarity, with a value such as Legendary, is the creator’s own label, and you can filter by it like any other trait.

Filtering a collection by trait

On a collection’s Items tab, the filters list every value of every trait. Beside each is how many NFTs have it and, when any of them is listed, the lowest listed price.

Values of different traits narrow the list: an NFT has to match every trait you chose. Values of the same trait widen it: an NFT can have any of them.

The Traits tab lays every value out on its own card, with a few of the NFTs that have it, to compare rather than pick from. Sort by floor, by rarity or by top offer, search by value or trait name, or narrow it to some traits. Each value opens the Items tab filtered by it. Beside each value:

Trait count
how many NFTs in the collection have this value. Sorting by rarity puts the fewest first.
Trait floor
the lowest price among their listings. The activity and prices guide explains what a floor includes.
Top offer
the highest open bid on any one of them. The XRP Ledger has no offer on a trait as a whole, so this is the best offer an owner of such an NFT could accept today.

These counts are refreshed in the background, so a listing made or sold in the last few minutes may not be in them yet.

How rank and score are worked out

The percentage beside each trait on an NFT’s page is the share of its collection that has that value. It describes one trait; a rank describes the whole NFT.

An NFT’s score comes from how often each of its traits appears in its collection: the rarer its traits, the higher its score. Its rank is its place when the collection is sorted by score, rarest first.

Each collection is scored one way, and that way is recorded with it, so every NFT in a collection is measured alike. A rank compares an NFT only with the rest of its own collection.

  • NFTs with the same score share a rank, and the next rank skips the places they share.
  • Not having a trait that other NFTs in the collection have does not count as a trait of its own.
  • An NFT with no traits recorded has no rank. Having no traits is not rarity; it means there is nothing to measure.

Until a collection has been scored, or while not all of its NFTs have been counted, its NFTs show no rank. On its About tab, Rarity computed shows when its rarity was last worked out.

An NFT’s page shows its rank and, when it has one, its score. To sort a collection by rank, choose Rarity: rarest first on its Items tab.

The rankings a creator can choose

A collection’s creator chooses how its NFTs are ranked, from its page’s settings. Its About tab says which ranking is in use.

  • Overall rarity: every rare trait counts, multiplied together. An NFT with several rare traits ranks well above one with a single rare trait. This is what a collection uses until its creator chooses.
  • Rarity score: adds up how rare each trait is. NFTs with more traits tend to rank higher.
  • Consistently rare: an NFT ranks high only if all of its traits are uncommon; one common trait pulls it down.
  • Creator’s ranking: the creator’s own ranks, from a rank in each NFT’s metadata or from a list they uploaded. We show them as they are and give them no score.

A creator can also choose not to show rarity. Their collection’s NFTs then show no rank, and it can’t be sorted or filtered by rank. Trait percentages still show: they describe the traits, not a ranking.

Ranks are worked out again as NFTs mint and as their traits change, and whenever the creator changes the ranking. During a drop, the ranking stays as buyers saw it until the drop ends.

Ranks a creator publishes

Some creators publish their own ranks, in their NFTs’ metadata or as a list they upload. Where a collection is ranked by its creator, the rank you see is theirs, its About tab says so, and there is no score.

We cannot reproduce how a creator worked out their ranks, so we repeat them rather than replace them with our own.

What rarity does not tell you

Rarity measures how uncommon an NFT’s traits are. It is not a price or a valuation, and it is not a recommendation: a rare NFT can sell for less than a common one.

Other marketplaces may rank the same NFT differently. They may score it another way, or count a missing trait as a rare one, which First Ledger does not.

A rank can change. Ranks are worked out again as more of a collection’s NFTs are read, and when an NFT’s metadata changes and is read again. The dynamic NFTs guide explains who can change an NFT’s metadata.

Rarity and traits · First Ledger NFT