# NFT Collection Valuation Signals

> NFT Collection Valuation Signals is a paid API for AI agents from defi-shield-hazel.vercel.app, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-13).

Analyzes an NFT collection contract to produce valuation signals including transfer velocity, holder metrics, whale concentration, and market activity assessment

## Facts

- Endpoint: POST https://defi-shield-hazel.vercel.app/api/nft/valuation
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-shield-hazel-vercel-app-1ab68e10
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mX35YEp1D_V2yJopaAE7C

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability defi-shield-hazel-vercel-app-1ab68e10 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## Output

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.

## Example request

```json
{
 "collection_address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
}
```

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-shield-hazel-vercel-app-1ab68e10/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi-shield-hazel.vercel.app](https://www.zero.xyz/host/defi-shield-hazel.vercel.app/llms.txt)