Skip to main content

NFT Traits & Rarity

ยท One min read

Our latest update enhances our NFT Traits feature and introduces NFT Rarity, allowing you to access detailed trait data and rarity scores for ERC721 and ERC1155 collections. ๐Ÿ”ฅ

Traits have been extended to include:

  • count: The total occurrences of this attribute/trait.
  • percentage: The percentage of NFTs that possess this trait.
  • rarity_label: A label indicating the rarity based on the percentage (e.g., "Top 1% trait").

Rarity scores have been added to all NFTs:

  • rarity_rank: A numerical rank based on its rarity score.
  • rarity_percentage: The percentage indicating its rarity relative to the entire collection.
  • rarity_label: A label that describes how rare the NFT is (e.g., "Top 1% rarity").

New Endpointsโ€‹

NameEndpointAPI Reference
Get NFT Traits by Collection (single response, limited to 5,000 traits)/nft/:address/traitsMethod Documentation
Get NFT Traits by Collection (paginated, no limit)/nft/:address/traits/paginateMethod Documentation
Get NFTs by Traits/nft/:address/nfts-by-traitsMethod Documentation
Resync NFT Traits by Collection/nft/:address/traits/resyncMethod Documentation

Rarity Enrichmentโ€‹

NFT rarity data has been added to the following endpoints:

NameEndpointAPI Reference
Get NFTs by Wallet/:address/nftsMethod Documentation
Get NFTs by Collection/nft/:addressMethod Documentation
Get NFT Owners by Collection/nft/:address/ownersMethod Documentation
Get NFT Owners by Token Id/nft/:address/:token_id/ownersMethod Documentation
Get NFT Metadata/nft/:address/:token_idMethod Documentation

For more details on how rarity works and to see which endpoints include it, visit our NFT Rarity FAQs page.