{"uid":"cap_iJFLuXOesOa8JjToZmjAz","slug":"nft-token-rarity-rank-trait-floor-price-lookup-c9c9bfce","name":"NFT Token Rarity Rank & Trait Floor Price Lookup","description":"Get NFT token rarity rank, score, and trait floor prices (POST variant)","url":"https://nft-floor.api.klymax402.com/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":null,"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_lvfoAnxbbatXjOWFU2ui-","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 rarity rank, rarity score, and trait-level floor prices for a specific NFT token by contract address and token ID","exampleAgentPrompt":"What's the rarity rank and trait floor prices for token ID 4156 in the Bored Ape Yacht Club collection — the contract address is 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?","exampleUseCases":[{"title":"Pre-purchase NFT due diligence check","prompt":"Before I buy this Pudgy Penguins NFT, can you pull up its rarity rank and see what the trait floors are? The token ID is 8923 and the contract is 0xBd3531dA5DD0A74fb411a9d0b3B7d0d23f7c5BD0 on Ethereum."},{"title":"Building rarity-filtered marketplace listings","prompt":"I'm cataloging premium NFTs for my collection — show me the rarity scores and trait-level floor prices for token 1567 in the Moonbirds collection at 0x23581767a106ae21c074b2276D25e15C0ff0335d so I can tag it properly."},{"title":"Comparing value across trait combinations","prompt":"Help me understand this NFT's value proposition — what's the rarity rank for token 742 in the Azuki collection on Ethereum, and break down the individual trait floor prices so I can see which attributes are driving the price?"}],"resultDescription":"Returns the rarity rank of the token within its collection, a numerical rarity score, and floor prices broken down by individual traits, helping assess the token's scarcity and value relative to the broader collection.","failureModes":["Invalid or non-existent contract address returns an error or empty result","Token ID not found within the collection","Unsupported blockchain specified (only ethereum and base supported)","Collection not indexed or rarity data not available for the collection","Rate limiting or payment failure (x402 payment required at $0.003 USDC per call)"],"whenToPreferThis":"Use this endpoint when you need token-level rarity data — rank, score, and trait-specific floor prices — for a specific NFT. Prefer this over the sibling collection-level stats endpoint when you need granular per-token analysis rather than aggregate collection metrics. Ideal for NFT valuation, pre-purchase due diligence, or building rarity-based filters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:37:53.536Z","isFirstParty":false}