# TokenGuard NFT Stats

> TokenGuard NFT Stats 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-14).

Returns on-chain NFT collection statistics including floor price, volume, holder counts, and market metrics for a given NFT collection.

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/nft_stats
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-nft-stats-abe35fe8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tuxfDXI9-sf5dw7gSXpZA

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-stats-abe35fe8 -d '<json body>'
```

Example prompt: Can you pull the current NFT stats for the Bored Ape Yacht Club collection — floor price, trading volume, and holder count?

## When to prefer this

Use this endpoint when you need real-time or recent on-chain NFT collection statistics (floor price, volume, holders) and are operating within a crypto/DeFi agent workflow that supports x402 micropayments. Prefer this over general-purpose blockchain explorers when you want structured, analytics-ready JSON output without scraping. Best for EVM-compatible NFT collections.

## Known failure modes

- Unknown or invalid collection address returns empty or error response
- Collection not indexed by TokenGuard returns no data
- Network mismatch between contract address and specified chain causes lookup failure
- Rate limiting or micropayment failure results in 402 or 429 error
- Very new or low-liquidity collections may return incomplete stats

## How this service works

nft stats data for AI agents.

## Output

A JSON object containing on-chain NFT collection statistics such as floor price (in ETH or native token), total trading volume, number of unique holders, total supply, number of sales, and market cap estimates for the queried collection.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [],
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-nft-stats-abe35fe8/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)