{"uid":"cap__8Bn1c3GDjmjM_7rQs7fY","slug":"klymax402-nft-rarity-score-lookup-3c09a69e","name":"klymax402 NFT Rarity Score Lookup","description":"One MCP endpoint gives your AI agent access to 100 APIs -- crypto, DeFi, web, AI, finance and utilities. No API keys, USDC on Base from $0.003/call.","url":"https://klymax402.com/api/nft-floor/api/rarity","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address","tokenId"],"properties":{"chain":{"type":"string","description":"Blockchain: ethereum or base. Default: ethereum"},"address":{"type":"string","description":"NFT collection contract address"},"tokenId":{"type":"string","description":"Token ID within the collection. e.g. 1234"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"example","traits":[],"address":"example","tokenId":"example","rarityRank":1,"rarityScore":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GLzCEBsKcUp66IpfqsmrL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the rarity rank and rarity score for a specific NFT token within a collection on Ethereum or Base.","exampleAgentPrompt":"What's the rarity rank and score for token ID 1234 in the Bored Ape Yacht Club collection at contract address 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?","exampleUseCases":[{"title":"Check rarity before buying an NFT","prompt":"Before I bid on this NFT, can you check how rare token ID 4567 is from the Azuki collection at 0xED5AF388653567Af2F388E6224dC7C4b3241C544 on Ethereum? I want its rarity rank and score."},{"title":"Compare rarity across collection","prompt":"I own token 8888 from the CloneX collection at contract 0x49cF6f5d44E70224e2E23fDcdd2C053F30aDA28B on Ethereum — what's its rarity rank within the collection?"},{"title":"NFT rarity check on Base chain","prompt":"Can you look up the rarity rank and score for token 99 from the NFT collection at 0xabcdef1234567890abcdef1234567890abcdef12 on Base?"}],"resultDescription":"Returns a JSON object containing the chain, contract address, token ID, rarity rank (integer position within the collection), rarity score (numeric rarity value), and an array of the token's traits used to compute rarity.","failureModes":["Invalid or non-existent contract address returns an error","Token ID not found within the collection returns an error","Unsupported chain (not ethereum or base) returns an error","Rate limiting or payment failure results in 402 response","Collection not indexed for rarity returns empty or error response"],"whenToPreferThis":"Use this endpoint when you need rarity rank and score for a specific NFT token on Ethereum or Base. Prefer this over floor price endpoints when the user wants to understand how rare a particular token is within its collection, not just its market price. Good for pre-purchase due diligence or portfolio analysis of NFT holdings.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:53:18.157Z","isFirstParty":false}