NFT Rarity Ranking Tool
Free to download on every platform. Comes pre-installed on BotFone, BotPad and BotFlip — with extra free apps included.
About this app
WHAT IT DOES
The NFT Rarity Ranking Tool scans any ERC-721 or ERC-1155 collection, fetches metadata for each token via tokenURI(), extracts trait attributes, and calculates rarity scores based on trait frequency across the collection. It uses a statistical rarity model where rarer traits contribute more to a token's overall score: for each token, the tool sums the inverse frequency of each trait it possesses (rarer traits = higher scores). The tool then ranks all tokens from most rare to least rare, displays the ranking list, and shows individual token details including rank, score, and trait composition. This helps collectors identify valuable, scarce NFTs within a collection.
HOW TO USE
1. Connect your EVM wallet (optional—the tool works without it).
2. Select your chain: Ethereum (1), Polygon (137), or Arbitrum (42161).
3. Enter the NFT collection contract address.
4. Optionally enter a specific token ID to check its rarity.
5. Set the max number of tokens to scan (larger collections may take longer).
6. Click "Scan & rank" to fetch metadata and compute rarity scores.
7. Review the ranking list and the specific token details.
THE REAL MECHANISM — trait-frequency based rarity scoring with rate-limited fetching
This tool performs a multi-step rarity analysis. First, it calls tokenURI() for each token in the collection to retrieve the metadata URI. It then fetches the metadata JSON from IPFS or HTTPS using GM_xmlhttpRequest, with automatic IPFS gateway conversion (ipfs:// → https://ipfs.io/ipfs/). Second, it builds a frequency map of every trait value across all scanned tokens, counting how many tokens share each trait. Third, for each token, it calculates a rarity score as the sum of the inverse frequency of its traits: score = Σ(1 / trait_frequency). A trait that appears in only 1 of 100 tokens contributes 1.0 to the score, while a trait appearing in 50 of 100 tokens contributes 0.02. Finally, tokens are sorted by descending score and assigned a rank. The tool includes a progress bar and handles rate limits by inserting small delays between requests.
WHAT IT CANNOT SEE
- This tool cannot calculate rarity scores for collections that do not expose metadata via standard tokenURI() or where metadata is not accessible.
- It cannot compute accurate rarity without scanning the full collection supply—scanning only a subset will produce incomplete results.
- It cannot detect traits that are not explicitly listed in the metadata attributes array (e.g., image traits, hidden properties).
- It cannot access metadata that is stored off-chain and unreachable via IPFS gateways.
- It cannot compare rarity across different collections without a standardized trait schema.
- It cannot verify if the metadata is authentic or has been modified after minting.
PLEASE NOTE
- This tool works on Ethereum (1), Polygon (137), and Arbitrum (42161).
- Scanning large collections (1000+ tokens) may take several minutes and may hit rate limits.
- The tool uses the standard tokenURI() function—contracts with non-standard implementations may not work.
- IPFS metadata is fetched via public gateways; gateway downtime or rate limits may affect results.
- Rarity scores are relative to the scanned subset—if you don't scan the entire collection, the ranking may not be accurate.
- This tool is read-only and does not submit any transactions.
Similar Apps
