tezos-rarity-pfp-collections

Rarity (scores and ranks) for Tezos PFP collections and other FA2 NFT collections

The aim is to establish a rarity score and rank calculation that is used consistently across collections. Here's the process that will be followed for all collections.

how rarity score is calculated

For the entire collection, all attributes and attribute values are identified e.g. Hair: Messy (Attribute: Attribute Value)
For tokens that don't have a specific attribute, the attribute along with a value of "None" will be applied and included in the calculation. However, attributes with value of "None" will not be counted toward the NFT's attribute count.
For the entire collection, all instances of an attribute value are counted
The total number of tokens in the collection is divided by the total count of an attribute value. e.g. 1000/30 (1000 token collection, attribute value used 30 times) = rarity score of 33.33
Additionally, a rarity score for the number of attributes is generated and added to the sum. e.g. 5 tokens have 1 attribute, 100 tokens have 5 attributes, 300 tokens have 4 attributes, 550 tokens have 6 attributes, etc. Tokens with 1 attribute would be the most rare in this case.

Once the overall scores are determined per attribute value:

Per token, a sum is made of the rarity score of each attribute value that the token has. That is the token's final rarity score.

how rank is calculated

Starting with the highest rarity score, tokens receive a rank, beginning with Rank #1 (most rare)
If multiple tokens have the same rarity score, they receive the same rank. A count is taken of tokens with the same rank, and that many is added to the next rank.

For example: if 5 tokens have highest rarity score of 1000, they will each have rank #1. But the token with the next highest rarity score will have rank of #6.

So: #1, #1, #1, #1, #1, #6 (#2-#5 are skipped).

edge cases

when real token metadata has yet to be revealed, ignore

For tokens whose attributes have yet to be revealed (new mints). These tokens will be excluded from the report, and total token count will ignore these tokens. For example, these tokens can be identified when these conventions are used:

attribute name of 'Status' == 'Hidden', 'Incubating', etc (similar status values are added as needed)
attribute name of 'Revealed' == 'False'

remove 'meta' attributes

If summary metadata is included as an attribute like 'Rarity Score', don't evaluate it as an attribute

Name		Name	Last commit message	Last commit date
Latest commit History 113 Commits
ethereum		ethereum
fxhash		fxhash
sample-project-results		sample-project-results
BatBits.csv		BatBits.csv
README.md		README.md
REAVERSE.csv		REAVERSE.csv
TezLynx_Society.csv		TezLynx_Society.csv
TezoTrooperz.csv		TezoTrooperz.csv
TrooperzGenesis.csv		TrooperzGenesis.csv
TrooperzGenesis_incl_attrib_rarity_detail.csv		TrooperzGenesis_incl_attrib_rarity_detail.csv
TrooperzGenesis_metadata_summary.json		TrooperzGenesis_metadata_summary.json
big_foot_mafia_club.csv		big_foot_mafia_club.csv
big_foot_mafia_club.json		big_foot_mafia_club.json
big_foot_mafia_club_full.csv		big_foot_mafia_club_full.csv
big_foot_mafia_club_incl_attrib_rarity_detail.csv		big_foot_mafia_club_incl_attrib_rarity_detail.csv
big_foot_mafia_club_metadata_summary.json		big_foot_mafia_club_metadata_summary.json
bunny_knights_2nd_gen.csv		bunny_knights_2nd_gen.csv
bunny_knights_2nd_gen_incl_attrib_rarity_detail.csv		bunny_knights_2nd_gen_incl_attrib_rarity_detail.csv
chopsumo.csv		chopsumo.csv
cordae_identity.csv		cordae_identity.csv
cyber_gecko_gang.csv		cyber_gecko_gang.csv
cyberkidzclub.csv		cyberkidzclub.csv
degen_foxes.csv		degen_foxes.csv
diplomats_of_tezotopia.csv		diplomats_of_tezotopia.csv
dogami.csv		dogami.csv
dogami_incl_attrib_rarity_detail.csv		dogami_incl_attrib_rarity_detail.csv
fellowship_of_ilmeresh.csv		fellowship_of_ilmeresh.csv
flux_tribe.csv		flux_tribe.csv
froggos.csv		froggos.csv
glo_gang.csv		glo_gang.csv
gogos.csv		gogos.csv
hash_three_points-exclude_xy_movement.csv		hash_three_points-exclude_xy_movement.csv
hash_three_points-include_xy_movement.csv		hash_three_points-include_xy_movement.csv
hash_three_points_incl_attrib_rarity_detail-exclude_xy_movement.csv		hash_three_points_incl_attrib_rarity_detail-exclude_xy_movement.csv
hash_three_points_incl_attrib_rarity_detail-include_xy_movement.csv		hash_three_points_incl_attrib_rarity_detail-include_xy_movement.csv
hash_three_points_metadata_summary-exclude_xy_movement.json		hash_three_points_metadata_summary-exclude_xy_movement.json
hash_three_points_metadata_summary-include_xy_movement.json		hash_three_points_metadata_summary-include_xy_movement.json
inkspunks.csv		inkspunks.csv
kumulus.csv		kumulus.csv
les_elephants_terribles.csv		les_elephants_terribles.csv
mekatron.csv		mekatron.csv
monarx.csv		monarx.csv
neonz.csv		neonz.csv
ottez.csv		ottez.csv
owlz.csv		owlz.csv
oxtazy.csv		oxtazy.csv
oxtazy.json		oxtazy.json
oxtazy_incl_attrib_rarity_detail.csv		oxtazy_incl_attrib_rarity_detail.csv
oxtazy_metadata_summary.json		oxtazy_metadata_summary.json
parrotz.csv		parrotz.csv
pixel_panda.csv		pixel_panda.csv
prjktneon.csv		prjktneon.csv
raggedz.csv		raggedz.csv
sad_python.csv		sad_python.csv
sad_python.json		sad_python.json
sad_python_incl_attrib_rarity_detail.csv		sad_python_incl_attrib_rarity_detail.csv
sad_python_metadata_summary.json		sad_python_metadata_summary.json
tacodudez.csv		tacodudez.csv
tez_dozen.csv		tez_dozen.csv
tez_dozen_incl_attrib_rarity_detail.csv		tez_dozen_incl_attrib_rarity_detail.csv
tezapegang.csv		tezapegang.csv
tezos_farmation.csv		tezos_farmation.csv
tezos_farmation.json		tezos_farmation.json
tezos_farmation_incl_attrib_rarity_detail.csv		tezos_farmation_incl_attrib_rarity_detail.csv
tezos_farmation_metadata_summary.json		tezos_farmation_metadata_summary.json
tezos_pirates.csv		tezos_pirates.csv
tezumura.csv		tezumura.csv
tezzardz.csv		tezzardz.csv
the_moments.csv		the_moments.csv
tzcolors.csv		tzcolors.csv
tzcolors_incl_attrib_rarity_detail.csv		tzcolors_incl_attrib_rarity_detail.csv
tzcolors_metadata_summary.json		tzcolors_metadata_summary.json
unibotz.csv		unibotz.csv
vessels_gen0.csv		vessels_gen0.csv
witchez.csv		witchez.csv
witchez_incl_attrib_rarity_detail.csv		witchez_incl_attrib_rarity_detail.csv
witchez_metadata_summary.json		witchez_metadata_summary.json
ziggurats.csv		ziggurats.csv

tezdealer/tezos-rarity-pfp-collections

Folders and files

Latest commit

History