{"uid":"cap_mX35YEp1D_V2yJopaAE7C","slug":"defi-shield-hazel-vercel-app-1ab68e10","name":"NFT Collection Valuation Signals","description":"","url":"https://defi-shield-hazel.vercel.app/api/nft/valuation","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":{"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":{"collection_address":"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"},"response":{"note":"No NFT (ERC-721) transfers found for this address. It may not be an NFT collection contract.","velocity":0,"analyzed_at":"2026-06-16T01:07:16.542Z","whale_count":0,"transfers_7d":0,"transfers_24h":0,"transfers_30d":0,"activity_score":0,"activity_trend":"NONE","top_holder_pct":0,"collection_name":null,"holder_estimate":0,"response_time_ms":100,"collection_symbol":null,"market_assessment":"NO_DATA","assessment_factors":["No NFT transfers found — address may not be an NFT collection or has no on-chain activity."],"collection_address":"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D","collection_age_days":0,"daily_transfer_rate":0,"dex_cross_reference":null,"total_supply_estimate":0,"total_transfers_analyzed":0}},"exampleRequest":{"collection_address":"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"},"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EIJs7RwN2SCjSrT3S-hQy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes an NFT collection contract to produce valuation signals including transfer velocity, holder metrics, whale concentration, and market activity assessment","exampleAgentPrompt":"Pull the valuation signals for the Bored Ape Yacht Club NFT collection at 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D — I want to see its transfer velocity, whale count, holder estimate, and overall market assessment.","exampleUseCases":null,"resultDescription":"Returns transfer counts over 24h/7d/30d windows, an activity score and trend label, whale count, top holder percentage, estimated total holders and supply, collection age in days, daily transfer rate, a market assessment enum (e.g. NO_DATA, BEARISH, BULLISH), and a list of assessment factors explaining the rating.","failureModes":["Address is not an ERC-721 NFT contract — returns zero metrics and NO_DATA market assessment","Contract has no on-chain transfer history — all counts return 0","Invalid or malformed collection_address — likely 4xx error","Upstream RPC node timeout — may return partial data or 500 error"],"whenToPreferThis":"Use this endpoint when you need on-chain, transfer-activity-driven valuation signals for an NFT collection rather than floor price data from an NFT marketplace API. It is best for assessing collection health, whale concentration, and trading momentum directly from blockchain data without relying on centralized marketplace feeds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:48:02.178Z","isFirstParty":false}