# TokenGuard NFT Collection Analytics

> TokenGuard NFT Collection Analytics is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Returns on-chain NFT collection metrics including floor price, volume, owner count, and token count for a named collection

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/nft
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-nft-collection-analytics-9f959517
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_q9jqOJzE6ojKR7XpzwCyf

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 tokenguard-nft-collection-analytics-9f959517 -d '<json body>'
```

Example prompt: Pull up the NFT stats for Bored Ape Yacht Club — I want to know the current floor price in ETH and USD, how many unique owners there are, and the 24-hour trading volume.

## When to prefer this

Use this endpoint when you need quick, structured NFT collection-level statistics — floor price, volume, owner count, and token supply — without needing individual token or trait-level data. Ideal for AI agents doing market screening, portfolio valuation, or DeFi analytics on NFT assets. Prefer this over generic blockchain explorers when you need a ready-parsed JSON response with USD-denominated prices included.

## Known failure modes

- Unknown or misspelled collection name returns an error or empty result
- Collection not indexed on-chain returns no data
- Service downtime on Hugging Face Space may cause 503 errors
- Rate limiting or micropayment failure via x402 protocol blocks the request
- Collections with very low liquidity may return zero volume or floor price

## How this service works

NFT collection floor price, volume, owner/token count via Reservoir (free, no API key). Multi-chain: ethereum, polygon, base, optimism, arbitrum, zora.

## Output

A JSON object containing the collection name, number of unique owners, total token count, 24-hour trading volume in ETH, floor price in ETH, and floor price in USD for the requested NFT collection.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain: ethereum, polygon, base, optimism, arbitrum, zora (default: ethereum)"
  },
  "collection": {
   "type": "string",
   "description": "Collection slug (e.g. 'boredapeyachtclub') or contract address (0x...)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "collection": "Bored Ape Yacht Club",
  "owner_count": 6432,
  "token_count": 10000,
  "volume_24h_eth": 45.2,
  "floor_price_eth": 12.5,
  "floor_price_usd": 42500
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-nft-collection-analytics-9f959517/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)