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.