{"endpoint":"/api/nft/rarity","method":"POST","service_trust":"https://defi-shield-hazel.vercel.app/api/trust-signal","free_check":{"endpoint":"https://defi-shield-hazel.vercel.app/api/free/token-check","method":"POST","price":"FREE","note":"Try before you buy — free basic token safety check with risk math."},"also_available_on":{"virtuals_acp":{"agent":"Authensor","agent_id":18805,"offerings":["pre_trade_safety","token_deep_scan","wallet_report","batch_seal"],"marketplace":"https://app.virtuals.io/acp/scan/agents","note":"Same service, accessible to 18,000+ autonomous agents on Virtuals Protocol."},"mcp_server":{"package":"devsecure-mcp","install":"npx devsecure-mcp","tools":67,"note":"Install as MCP server in Claude, Cursor, or any MCP-compatible client for direct tool access."},"bazaar":"https://defi-shield-hazel.vercel.app/.well-known/x402","agent_card":"https://defi-shield-hazel.vercel.app/.well-known/agent-card.json"},"powered_by":"DeFi Shield by Authensor","price":"$0.25","description":"Analyzes rarity signals for a specific NFT token. Attempts to fetch on-chain tokenURI metadata (including IPFS and base64-encoded JSON). Falls back to transfer-based rarity analysis when metadata is unavailable.","llm_usage_prompt":"Call this endpoint when evaluating a specific NFT for purchase or appraisal. Provide collection_address and token_id. Returns rarity_signal (RARE/COMMON/HIGHLY_TRADED) based on transfer frequency vs collection average, collection_stats (total_supply_estimate, total_transfers), token_stats (transfer_count, unique_owner_count, current_owner), and when available: metadata_name, metadata_image, and traits array from on-chain tokenURI. The rarity_note explains methodology and data limitations. Costs $0.25.","params":{"collection_address":"string — The NFT contract address (0x + 40 hex chars)","token_id":"string — The token ID to analyze"},"exampleRequest":{"collection_address":"0xd4307e0acd12cf46fd6cf93bc264f5d5ae62f476","token_id":"42"},"exampleResponse":{"token_id":"42","collection_address":"0xd4307e0acd12cf46fd6cf93bc264f5d5ae62f476","rarity_signal":"RARE","collection_stats":{"total_supply_estimate":500,"total_transfers":4200,"avg_transfers_per_token":8.4},"token_stats":{"transfer_count":2,"unique_owner_count":2,"current_owner":"0xabcdef..."},"metadata_available":true,"traits":[{"trait_type":"Background","value":"Blue"}],"rarity_note":"Rarity signal is based on transfer frequency...","response_time_ms":1200}}