Description

Get the rarity of each attribute of an NFT.

Parameters

Response

NftAttributeRarity response parameters

Example Request and Response

Prerequisite: You will need to install the Alchemy SDK before making requests with it.

The commands for installing it using npm or yarn are given below:

npm install alchemy-sdk

yarn add alchemy-sdk

Request

// Imports the Alchemy SDK
const { Alchemy, Network } = require("alchemy-sdk");

// Configures the Alchemy SDK
const config = {
    apiKey: "alchemy-replit", // Replace with your API key
    network: Network.ETH_MAINNET, // Replace with your network
};

// Creates an Alchemy object instance with the config to use for making requests
const alchemy = new Alchemy(config);

const main = async () => {
    // define the contract address and tokenId
    const address = "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d";
    const tokenId = 145;

    //Call the method to display the rarity of each attribute of the NFT
    const response = await alchemy.nft.computeRarity(address, tokenId)

    //Logging the response to the console
    console.log(response)
}

main();

Response

[
  { prevalence: 0.1273, traitType: 'Background', value: 'Orange' },
  { prevalence: 0.013, traitType: 'Hat', value: 'Prussian Helmet' },
  { prevalence: 0.1551, traitType: 'Mouth', value: 'Bored Unshaven' },
  { prevalence: 0.1229, traitType: 'Fur', value: 'Black' },
  { prevalence: 0.0203, traitType: 'Clothes', value: 'Bone Necklace' },
  { prevalence: 0.0487, traitType: 'Eyes', value: '3d' }
]

Code Sandbox

You can test out the computeRarity method using the code sandbox below:

Use Cases

Here are some potential use cases for the computeRarity method:

• NFT marketplaces: NFT marketplaces such as OpenSea, Rarible, and SuperRare use the computeRarity method to calculate the rarity score of different NFTs, which helps determine their value in the marketplace.

• NFT collections: NFT collections such as CryptoKitties and CryptoPunks use the computeRarity method to determine the rarity of each NFT in their collection, which adds to the overall uniqueness and value of the collection.

• Gaming applications: Gaming applications that use NFTs often use the computeRarity method to calculate the rarity of different game items, such as weapons or armor, which can affect their in-game performance and value.

Related Methods

Here are the methods related to computeRarity:

• getNftMetadataBatch: Gets the NFT metadata for multiple NFT tokens.

• getNftMetadata: Gets the metadata associated with a given NFT.