NFT Rarity API – How to Get an NFT’s Rarity Ranking – Moralis Web3

In search of the simplest approach to get an NFT’s rarity rating? If that’s the case, you’ve come to the correct place. In as we speak’s information, we’ll introduce you to Moralis’ NFT Rarity API. This revolutionary interface introduces a couple of new endpoints and enriches our API responses with complete NFT rarity knowledge. As such, now you can question an NFT’s rarity rating with a single request. Are you desperate to learn the way this works? Try the pattern script under, the place we fetch the metadata of an NFT:

import fetch from 'node-fetch';

const choices = {
  methodology: 'GET',
  headers: {
    settle for: 'utility/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

fetch('https://deep-index.builders.moralis.com/api/v2.2/nft/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB/1?chain=eth', choices)
 .then(response => response.json())
 .then(response => console.log(response))
 .catch(err => console.error(err));

In return for calling the endpoint above, you’ll get the metadata of the desired NFT. Right here’s a pattern response: 

{
  quantity: '1',
  token_id: '1',
  token_address: '0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb',
  contract_type: 'CRYPTOPUNKS',
  owner_of: '0xffa914c83d851b9fe372e4ba6a6e131373aa16ab',
  last_metadata_sync: '2024-09-05T08:44:23.476Z',
  last_token_uri_sync: '2024-09-05T08:44:23.393Z',
  metadata: '{"picture":"https://www.larvalabs.com/cryptopunks/cryptopunk001.png","identify":"CryptoPunk 001","attributes":["Smile","Mohawk"],"description":"Male"}',
  block_number: '16079985',
  block_number_minted: null,
  identify: 'CRYPTOPUNKS',
  image: 'Ͼ',
  token_hash: 'a99d02058e62e327e79aabd57e0b88a3',
  token_uri: 'Invalid uri',
  minter_address: null,
  rarity_rank: 7247,
  rarity_percentage: 72.47,
  rarity_label: 'Prime 73%',
  verified_collection: true,
  possible_spam: false,
  collection_logo: 'https://i.seadn.io/gae/BdxvLseXcfl57BiuQcQYdJ64v-aI8din7WPk0Pgo3qQFhAUH-B6i-dCqqc_mCkRIzULmwzwecnohLhrcH8A9mpWIZqA7ygc52Sr81hE?w=500&auto=format',
  collection_banner_image: 'https://i.seadn.io/gae/48oVuDyfe_xhs24BC2TTVcaYCX7rrU5mpuQLyTgRDbKHj2PtzKZsQ5qC3xTH4ar34wwAXxEKH8uUDPAGffbg7boeGYqX6op5vBDcbA?w=500&auto=format'
}

Along with metadata, the response comprises three key rarity parameters: rarity_rank, rarity_percentage, and rarity_label:

//...
  rarity_rank: 7247,
  rarity_percentage: 72.47,
  rarity_label: 'Prime 73%',
//...

That’s it; fetching an NFT’s rarity is straightforward when working with Moralis. Nevertheless, in order for you a extra in-depth rationalization of how this works, be a part of us in as we speak’s information as we lay all of it out for you. 

Are you keen to begin leveraging our APIs your self? Don’t overlook to enroll with Moralis. You may arrange your account without spending a dime, and also you’ll achieve instant entry to our APIs and premier RPC nodes! 

Overview

The idea of rarity is essential for the NFT market because it impacts the value of particular person tokens and drives demand. Nevertheless, figuring out the rarity of a token is simpler stated than executed, as you want a stable system to find out an NFT’s uniqueness. And arising with a system is a tedious and time-consuming activity. Luckily, it’s with this in thoughts that we launched our NFT Rarity API.

With Moralis’ NFT Rarity API, now you can effortlessly get any NFT’s rarity rating with a single API request. However how does this work? How is our rarity rating calculated? And what endpoints are supported? For the solutions to those questions, tag alongside on this tutorial. Let’s dive straight in! 

What’s NFT Rarity?

NFT rarity refers back to the uniqueness of an NFT inside a selected assortment, which is often decided by how frequent or unusual the token’s attributes/traits are. In NFT collections, sure traits or traits – akin to background, colour, equipment, and so on. – may be extra uncommon than others. The much less continuously a trait happens, the rarer and doubtlessly extra priceless the NFT is taken into account to be. 

However why does NFT rarity matter? 

NFT rarity performs an important position within the worth and desirability of tokens. Collectors, buyers, and crypto lovers usually seek for NFTs with uncommon traits, as they often maintain larger worth in the long run. 

Whereas rarity may be calculated in a number of methods, it sometimes entails analyzing the frequency of sure traits throughout the complete assortment. Based mostly on this, a rarity rating is assigned, and every NFT is ranked accordingly. 

All in all, the idea of NFT rarity is key to the market, driving demand and affecting the value of particular person NFTs! 

Introducing Moralis’ NFT Rarity API – The Best Solution to Get an NFT’s Rarity Rating

With Moralis’ introduction of the NFT Rarity API, now you can seamlessly get an NFT’s rarity rating with out breaking a sweat. The NFT Rarity API introduces a couple of new endpoints and enriches our API responses with rarity-related knowledge. As such, when querying NFT balances, metadata, collections, and so on., you’ll routinely get the rarity rating of all NFTs!

The NFT Rarity API assigns every NFT three key parameters:

• rarity_rank: A numerical rank primarily based on the NFT’s rarity rating.
• rarity_percentage: A share indicating the token’s rarity relative to the complete assortment.
• rarity_label: A label describing how uncommon the NFT is (e.g., “Prime 5% rarity”).

All in all, the NFT Rarity API makes it simple so that you can seamlessly question an NFT’s rarity rating with only a single API name!

How is the Rarity Rating Calculated?

Moralis’ NFT rarity algorithm is a custom-designed methodology that calculates the rarity of any given token inside a group with precision. The algorithm components within the whole variety of tokens within the assortment, the variety of copies of the NFT, and the traits that contribute to an NFT’s uniqueness. The formulation assigns a numerical worth to every trait, which is then added collectively to find out the general rarity rating. 

Inside an NFT assortment, every trait is analyzed and assigned the next three: 

• depend: The whole variety of occurrences of this attribute/trait. 
• share: The proportion of tokens that possess the attribute/trait. 
• rarity_label: A label displaying the rarity primarily based on the proportion (e.g., ”Prime 5% trait”).

From there, every NFT is then assigned the parameters described within the earlier part: 

• rarity_rank
• rarity_percentage
• rarity_label

What Collections Does the NFT Rarity API Assist?

The NFT Rarity API helps ERC-721 and ERC-1155 collections with a most restrict of fifty,000 tokens. Rarity calculations are solely carried out when the situations under are met: 

1. The gathering’s contract follows the ERC-721 or ERC-1155 requirements. 
2. The variety of NFTs within the assortment is fewer than 50,000.
3. The metadata and traits for all tokens within the assortment have been requested. 

What Endpoints Does the NFT Rarity API Cowl?

Right here’s a listing of recent endpoints which can be out there: 

• /nft/:handle/traits: Get NFT traits by assortment (one response, restricted to five,000 traits). 
• /nft/:handle/traits/paginate: Fetch NFT traits by assortment (paginated, no restrict).
• /nft/:handle/nfts-by-traits: Get NFTs by traits.
• /nft/:handle/traits/resync: Resync NFT traits by assortment. 

NFT rarity knowledge has been added to the next endpoints: 

• /:handle/nfts: Get NFTs by pockets.
• /nft/:handle: Fetch NFTs by assortment.
• /nft/:handle/homeowners: Question NFT homeowners by assortment.
• /nft/:handle/:token_id/homeowners: Get NFT homeowners by token id. 
• /nft/:handle/:token_id: Fetch NFT metadata. 

Try the NFT Rarity documentation web page to study extra! 

Full Tutorial: How one can Get an NFT’s Rarity Rating in 3 Steps

We’ll now stroll you thru a tutorial on how one can get an NFT’s rarity utilizing the Moralis NFT Rarity API. With this premier characteristic, you may simply get the info you want in three easy steps:

1. Get a Moralis API Key
2. Write a Script Calling the getNFTMetadata Endpoint
3. Run the Code

Nevertheless, earlier than shifting on, you’ll want to maintain a few conditions. 

Stipulations

Earlier than persevering with with step one, guarantee you may have the next prepared:

Step 1: Get a Moralis API Key

Click on the ”Begin for Free” button on the prime proper and arrange your Moralis account: 

When you log in, you’ll discover your API key immediately underneath the ”House” tab: 

Copy and hold the important thing for now, as you’ll want it within the following step.

Step 2: Write a Script Calling the getNFTMetadata Endpoint

Launch your most popular IDE, arrange a folder, and initialize your undertaking with the next terminal command:

npm init

Set up the required dependencies by working the instructions under in your terminal:

npm set up node-fetch --save
npm set up moralis @moralisweb3/common-evm-utils

Add "kind": "module" to your ”bundle.json” file:

Create an ”index.js” file and add the next code:

import fetch from 'node-fetch';

const choices = {
  methodology: 'GET',
  headers: {
    settle for: 'utility/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

fetch('https://deep-index.builders.moralis.com/api/v2.2/nft/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB/1?chain=eth', choices)
 .then(response => response.json())
 .then(response => console.log(response))
 .catch(err => console.error(err));

Exchange YOUR_API_KEY with the important thing you copied throughout step one, and configure the handle and tokenId parameters:

Step 3: Run the Code

Execute the next terminal command in your undertaking’s root folder to run the code: 

node index.js

In return, you’ll get the metadata of the desired NFT. Right here’s a pattern response: 

{
  quantity: '1',
  token_id: '1',
  token_address: '0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb',
  contract_type: 'CRYPTOPUNKS',
  owner_of: '0xffa914c83d851b9fe372e4ba6a6e131373aa16ab',
  last_metadata_sync: '2024-09-05T08:44:23.476Z',
  last_token_uri_sync: '2024-09-05T08:44:23.393Z',
  metadata: '{"picture":"https://www.larvalabs.com/cryptopunks/cryptopunk001.png","identify":"CryptoPunk 001","attributes":["Smile","Mohawk"],"description":"Male"}',
  block_number: '16079985',
  block_number_minted: null,
  identify: 'CRYPTOPUNKS',
  image: 'Ͼ',
  token_hash: 'a99d02058e62e327e79aabd57e0b88a3',
  token_uri: 'Invalid uri',
  minter_address: null,
  rarity_rank: 7247,
  rarity_percentage: 72.47,
  rarity_label: 'Prime 73%',
  verified_collection: true,
  possible_spam: false,
  collection_logo: 'https://i.seadn.io/gae/BdxvLseXcfl57BiuQcQYdJ64v-aI8din7WPk0Pgo3qQFhAUH-B6i-dCqqc_mCkRIzULmwzwecnohLhrcH8A9mpWIZqA7ygc52Sr81hE?w=500&auto=format',
  collection_banner_image: 'https://i.seadn.io/gae/48oVuDyfe_xhs24BC2TTVcaYCX7rrU5mpuQLyTgRDbKHj2PtzKZsQ5qC3xTH4ar34wwAXxEKH8uUDPAGffbg7boeGYqX6op5vBDcbA?w=500&auto=format'
}

As you may see, the response comprises three parameters that we’re notably fascinated by: rarity_rank, rarity_percentage, and rarity_label: 

//...
  rarity_rank: 7247,
  rarity_percentage: 72.47,
  rarity_label: 'Prime 73%',
//...

Congratulations! You now know how one can get an NFT’s rarity rating utilizing our NFT Rarity API! 

NFT Rarity API Use Circumstances

The NFT Rarity API has many use instances, as many platforms can profit from NFT rarity-related knowledge. Listed here are three key examples: 

• Web3 Video games: NFT-based Web3 video games can profit from rarity-related knowledge, giving customers higher perception into how distinctive their in-game belongings/objects truly are. 

• NFT Marketplaces: With rarity rankings, it’s attainable for NFT marketplaces to present customers higher perception into the individuality of NFTs being traded on the platform. It will assist merchants make extra knowledgeable funding selections.

• Token Analytics: Token analytics platforms can provide customers deeper perception into the worth of NFTs with our NFT Rarity API. 

The use instances above are solely three examples, and the NFT Rarity API will likely be helpful for many platforms that want entry to NFT knowledge! 

Past the NFT Rarity API – Exploring Moralis’ APIs & RPC Nodes

Moralis is the main knowledge supplier throughout the crypto area. In our suite of improvement instruments, you’ll discover next-generation RPC nodes and a number of use case-specific APIs, together with the Pockets API, Token API, Streams API, and so on. As such, when utilizing Moralis, you get all crypto knowledge in a single place.

However what makes Moralis particular? 

• One Name – All of the Knowledge: With our APIs and Prolonged RPC Strategies, you get extra knowledge with fewer calls. Fetch a pockets’s full historical past, token balances with costs, and rather more with single requests. 
• Actually Cross-Chain: Moralis helps all main chains, together with Ethereum, Base, Optimism, BNB Good Chain (BSC), and plenty of extra. Expertise full characteristic parity throughout these networks so you may streamline your developer expertise. 
• Enterprise-Grade Safety: Moralis is SOC 2 Sort 2 licensed, highlighting our dedication to top-tier safety and reliability. 

Now, let’s dive deeper into our suite of improvement instruments, beginning with the APIs.

Web3 APIs

Our suite of Web3 APIs consists of a number of use case-specific interfaces. Listed here are three key examples: 

• Pockets API: The Wallet API is a premier device for constructing wallets and integrating pockets performance into dapps. Use this interface to fetch any pockets’s full historical past, web price, profitability, token balances, and rather more. 
• Token API: Moralis’ Token API is your go-to device for ERC-20 knowledge, supporting each single token throughout all main chains. Get token balances, transactions, costs, and extra with one API name. 
• Streams API: The Streams API is the {industry}’s main real-time knowledge answer. Arrange Web3 knowledge pipelines on the click on of a button to stream knowledge immediately into the backend of your dapps as quickly as on-chain occasions happen. 

Try the Web3 API web page to study extra about all our interfaces! 

RPC Nodes

With Moralis’ premier node service, now you can seamlessly entry RPC nodes for all main chains on the click on of some buttons. Supported chains embrace Ethereum, Polygon, Base, Optimism, and plenty of extra! 

What makes our RPC nodes distinctive? 

• Pace: Our RPC nodes are lightning-fast, with response instances from 70 ms. 
• Reliability: Expertise 99.9% reliability with Moralis’ RPC nodes.
• Prolonged RPC Strategies: With our Extended RPC Methods, now you can seamlessly question decoded, human-readable knowledge along with your nodes. 

To study extra about this, try our RPC nodes web page! 

Abstract: NFT Rarity API – How one can Get an NFT’s Rarity Rating

NFT rarity is a vital idea for the NFT market, driving demand and influencing the value of particular person tokens. Nevertheless, it’s fairly difficult to find out the rarity of an NFT, as you’ll want to examine traits in collections, rank these traits, and assign a rating. We all know the struggles of doing so, which is why we launched our NFT Rarity API! 

The NFT Rarity API makes it simple for anybody to seamlessly question trait knowledge and entry rarity rankings for ERC-721 and ERC-1155 NFT collections. As such, it’s now simpler than ever to get an NFT’s rarity rating. 

To reveal the accessibility of this premier characteristic, try this pattern script displaying you the way simple it’s to fetch the rarity rating of an NFT: 

import fetch from 'node-fetch';

const choices = {
  methodology: 'GET',
  headers: {
    settle for: 'utility/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

fetch('https://deep-index.builders.moralis.com/api/v2.2/nft/0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB/1?chain=eth', choices)
 .then(response => response.json())
 .then(response => console.log(response))
 .catch(err => console.error(err));

In return for calling the script above, you’ll get the metadata of the desired NFT. Right here’s a pattern response: 

{
  quantity: '1',
  token_id: '1',
  token_address: '0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb',
  contract_type: 'CRYPTOPUNKS',
  owner_of: '0xffa914c83d851b9fe372e4ba6a6e131373aa16ab',
  last_metadata_sync: '2024-09-05T08:44:23.476Z',
  last_token_uri_sync: '2024-09-05T08:44:23.393Z',
  metadata: '{"picture":"https://www.larvalabs.com/cryptopunks/cryptopunk001.png","identify":"CryptoPunk 001","attributes":["Smile","Mohawk"],"description":"Male"}',
  block_number: '16079985',
  block_number_minted: null,
  identify: 'CRYPTOPUNKS',
  image: 'Ͼ',
  token_hash: 'a99d02058e62e327e79aabd57e0b88a3',
  token_uri: 'Invalid uri',
  minter_address: null,
  rarity_rank: 7247,
  rarity_percentage: 72.47,
  rarity_label: 'Prime 73%',
  verified_collection: true,
  possible_spam: false,
  collection_logo: 'https://i.seadn.io/gae/BdxvLseXcfl57BiuQcQYdJ64v-aI8din7WPk0Pgo3qQFhAUH-B6i-dCqqc_mCkRIzULmwzwecnohLhrcH8A9mpWIZqA7ygc52Sr81hE?w=500&auto=format',
  collection_banner_image: 'https://i.seadn.io/gae/48oVuDyfe_xhs24BC2TTVcaYCX7rrU5mpuQLyTgRDbKHj2PtzKZsQ5qC3xTH4ar34wwAXxEKH8uUDPAGffbg7boeGYqX6op5vBDcbA?w=500&auto=format'
}

This response is enriched with three key parameters: rarity_rank, rarity_percentage, and rarity_label:

//...
  rarity_rank: 7247,
  rarity_percentage: 72.47,
  rarity_label: 'Prime 73%',
//...

That’s it; getting an NFT’s rarity rating is that this simple, because of Moralis’ NFT Rarity API! 

In case you favored this NFT Rarity API article, take into account studying extra guides right here on the Moralis weblog. As an example, try our Address Labeling API information or discover ways to get token prices with an RPC node. 

Additionally, in case you want to use the NFT Rarity API your self, don’t overlook to enroll with Moralis. You may create an account freed from cost, and also you’ll get instant entry to all our industry-leading improvement instruments.