{"uid":"cap_OJawuyEdZJttdQ3Fzqkju","slug":"defi-shield-hazel-vercel-app-68ea0cb1","name":"NFT Rarity & Metadata Analyzer","description":"","url":"https://defi-shield-hazel.vercel.app/api/nft/rarity","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"properties":{"token_id":{"type":"number","description":"Token ID to analyze"},"collection_address":{"type":"string","description":"NFT collection contract address"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"body":{"token_id":4521,"collection_address":"0xbc4ca0eda7647a8ab7c2061c2e2ad7d64fda3371"},"type":"http","method":"POST","bodyType":"json"}},"response":{"traits":null,"token_id":"4521","token_uri":null,"analyzed_at":"2026-06-16T01:17:52.755Z","rarity_note":"Rarity signal is based on transfer frequency relative to collection average. No on-chain tokenURI available. Rarity assessment is based solely on transfer patterns. ","token_stats":{"current_owner":null,"transfer_count":0,"unique_owner_count":0},"metadata_name":null,"rarity_signal":"HIGHLY_TRADED","metadata_image":null,"collection_stats":{"collection_name":null,"total_transfers":0,"total_supply_estimate":0,"avg_transfers_per_token":0},"response_time_ms":44,"collection_address":"0xbc4ca0eda7647a8ab7c2061c2e2ad7d64fda3371","metadata_available":false}},"exampleRequest":{"token_id":4521,"collection_address":"0xbc4ca0eda7647a8ab7c2061c2e2ad7d64fda3371"},"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_i6vtiopUVr6RsLD65kJ4I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes NFT token rarity scores and metadata attributes to assess how rare or common a given NFT is within its collection","exampleAgentPrompt":"Can you check the rarity of NFT token ID 4521 from the Bored Ape Yacht Club collection — I want to know its rarity score, rank, and which traits make it rare or common?","exampleUseCases":null,"resultDescription":"Returns a rarity score and rank for the specified NFT token, along with a breakdown of its metadata attributes and trait frequencies within the collection, indicating how rare each trait is and an overall rarity tier classification.","failureModes":["Invalid or unrecognized contract address returns error","Token ID does not exist in the collection","Collection metadata not indexed or unavailable","Rate limit or payment validation failure returns 402","Network timeout if on-chain metadata fetch is slow"],"whenToPreferThis":"Use this endpoint when you need to programmatically assess the rarity of a specific NFT token within its collection, especially in DeFi or trading contexts where rarity impacts valuation. Prefer this over generic NFT APIs when you need trait-level frequency breakdowns and a ranked rarity score rather than just raw metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:56:37.981Z","isFirstParty":false}