# SYNTHORA NFT Collection Stats & Floor

> SYNTHORA NFT Collection Stats & Floor is a paid API for AI agents from nft-collection-stats-onchain.hergertsynthora.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns NFT collection statistics (floor price, 24h volume, market cap, supply, unique holders) for a given collection slug via CoinGecko data.

## Facts

- Endpoint: POST https://nft-collection-stats-onchain.hergertsynthora.com/service
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-nft-collection-stats-floor-27ae0f62
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C7V2mTwC874wUtv_WbsRj

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 synthora-nft-collection-stats-floor-27ae0f62 -d '<json body>'
```

Example prompt: Pull up the current NFT collection stats for Bored Ape Yacht Club — I need the floor price in USD, market cap, total supply, number of unique holders, and 24-hour volume so I can decide whether to bid.

## When to prefer this

Choose this endpoint when you need quick, structured NFT collection-level statistics (floor price, holder count, market cap, supply) sourced from CoinGecko for a known collection slug. It is ideal for autonomous NFT trading agents performing pre-bid liquidity and momentum screening, or for dashboards aggregating collection health signals. Prefer it over general web search when you need machine-readable, normalized data rather than prose. Not suitable for individual token (item-level) metadata, rarity scores, or real-time orderbook data.

## Known failure modes

- Invalid or unknown collection slug returns an error or empty result
- CoinGecko API rate limit exceeded causes a failed response
- Collection exists but has no recent trading data, resulting in null fields for volume and average price
- Network timeout reaching the upstream CoinGecko API
- Slug format mismatch (e.g. spaces vs hyphens) causes a lookup failure

## How this service works

Returns NFT collection statistics by slug from CoinGecko: floor price (native and USD), 24h volume, market cap, total supply and number of unique holder addresses. Powers autonomous NFT-trading agents and agent-to-agent collection screeners assessing liquidity, holder spread and floor momentum before bidding. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

A JSON object containing the collection name, symbol, floor price (in native token and USD), market cap, total supply, number of unique owner addresses, one-day sales count, one-day price change, and one-day volume. Data is sourced from CoinGecko's NFT endpoint and wrapped with provenance metadata indicating the source URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "keys": {
   "type": "string",
   "description": "keys"
  },
  "caller": {
   "type": "string",
   "description": "caller"
  },
  "payload": {
   "type": "string",
   "description": "payload"
  },
  "provides": {
   "type": "string",
   "description": "provides"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "nft-collection-stats-onchain",
  "result": {
   "name": "Bored Ape Yacht Club",
   "symbol": "BAYC",
   "market_cap": 164029042,
   "num_owners": 5689,
   "floor_price": 16406.19,
   "total_supply": 9998,
   "total_volume": null,
   "average_price": null,
   "one_day_sales": 5,
   "one_day_change": null,
   "one_day_volume": null
  },
  "provenance": {
   "url": "https://api.coingecko.com/api/v3/nfts/bored-ape-yacht-club",
   "source": "NFT Collection Stats & Floor"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-nft-collection-stats-floor-27ae0f62/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from nft-collection-stats-onchain.hergertsynthora.com](https://www.zero.xyz/host/nft-collection-stats-onchain.hergertsynthora.com/llms.txt)