# NFT Collection Intelligence

> NFT Collection Intelligence is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-13).

Fetches fused NFT collection metrics including floor price, market cap, volume, holders, supply, and computed health indicators (liquidity ratio, holder ratio, sales velocity, floor momentum) with a normalized market-health verdict.

## Facts

- Endpoint: GET https://api.agentstools.dev/nft/collection
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nft-collection-intelligence-4a807b39
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZKRkunALMtmcmnbNMYCQJ

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 nft-collection-intelligence-4a807b39
```

Example prompt: What's the market health of the Bored Ape Yacht Club NFT collection on Ethereum right now — give me the floor price, liquidity ratio, holder count, and your overall verdict on whether it's healthy?

## When to prefer this

Choose this endpoint when you need a holistic, computed view of an NFT collection's market health rather than just raw floor price. It is ideal when you want derived metrics like liquidity ratio, sales velocity, and floor momentum alongside a normalized verdict. It supports EVM chains via CoinGecko and Solana/Ordinals via Magic Eden in a single call, making it the best choice for cross-chain NFT analysis without managing multiple data sources. Prefer it over raw price feeds when the goal is investment due diligence, portfolio monitoring, or collection health scoring.

## Known failure modes

- Unknown or misspelled collection slug returns 404 or empty result
- Missing required chain parameter for ambiguous slugs causes lookup failure
- EVM contract address on wrong chain returns no data
- CoinGecko rate limits or outages degrade EVM collection responses
- Magic Eden downtime affects Solana and Bitcoin Ordinals lookups
- Collections with very low volume may have unreliable computed metrics

## How this service works

Flagship NFT collection intelligence: fuses identity, floor (native+USD), market cap, volume, total supply, holders and listed count into COMPUTED metrics — liquidity ratio (listed/supply + volume/mcap), holder/supply ratio, sales velocity and floor momentum — plus a normalized market-health verdict with confidence and rationale. EVM via CoinGecko, Solana + Bitcoin-Ordinals via Magic Eden. Keyless, attributed.

## Output

Returns a structured object with collection identity (name, slug, chain), floor price in native token and USD, market cap, 24h/7d volume, total supply, holder count, listed count, and computed metrics: liquidity ratio (listed/supply + volume/mcap), holder/supply ratio, sales velocity, floor momentum. Also includes a normalized market-health verdict (e.g. healthy, neutral, distressed), a confidence score, and a plain-language rationale explaining the verdict.

## Request schema (JSON Schema)

```json
{
 "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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "slug": {
       "type": "string",
       "description": "Collection id: a CoinGecko NFT id for EVM (e.g. bored-ape-yacht-club) or a Magic Eden collection symbol for solana / bitcoin."
      },
      "chain": {
       "enum": [
        "ethereum",
        "base",
        "polygon",
        "arbitrum",
        "optimism",
        "avalanche",
        "bsc",
        "solana",
        "bitcoin"
       ],
       "type": "string",
       "description": "Chain key. EVM names use CoinGecko; solana + bitcoin use Magic Eden. Optional when a global CoinGecko slug is given for an EVM collection."
      },
      "contract": {
       "type": "string",
       "description": "EVM contract address (0x + 40 hex). Use with an EVM chain."
      }
     }
    }
   },
   "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/nft-collection-intelligence-4a807b39/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)