# NFT Collection Metadata Lookup

> NFT Collection Metadata Lookup is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Fetches comprehensive metadata for an ERC-721 or ERC-1155 NFT collection by contract address across major EVM chains, including name, supply, floor price, OpenSea data, and social links.

## Facts

- Endpoint: POST https://agent402.tools/api/nft-collection
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nft-collection-metadata-lookup-e316ed44
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zSn9r7oTHZtBYgTAcMSbr

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-metadata-lookup-e316ed44 -d '<json body>'
```

Example prompt: Can you pull up the full metadata for the NFT collection at contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum — I want the name, floor price, total supply, OpenSea info, and any Twitter or Discord links.

## When to prefer this

Use this endpoint when you need rich, aggregated NFT collection metadata—including social links, OpenSea details, and floor price—from a single contract address lookup across Ethereum, Base, Polygon, Arbitrum, or Optimism. Prefer this over on-chain-only RPC calls when you need off-chain enrichment like OpenSea data and social profiles in one response.

## Known failure modes

- Invalid or non-NFT contract address returns an error or empty metadata
- Unsupported network name causes a validation error
- Contract exists but has no OpenSea listing, resulting in null floor/slug/image fields
- Rate limiting or network RPC issues causing timeouts
- Newly deployed contracts may have incomplete or missing metadata

## How this service works

Fetch NFT collection (ERC-721 / ERC-1155) metadata by contract address on Ethereum, Base, Polygon, Arbitrum, or Optimism: name, symbol, token type, total supply, deployer, OpenSea slug + image, floor (ETH), Twitter/Discord, and verification (safelist) status. Use to label a contract address with its collection identity before pulling tokens or sales.

## Output

Returns a structured object containing the collection's name, token symbol, token standard (ERC-721 or ERC-1155), total supply, deployer wallet address, OpenSea slug and image URL, current floor price in ETH, Twitter handle, Discord invite, and a verification/safety flag from OpenSea.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "network": {
   "type": "string",
   "description": "Chain: ethereum, base, polygon, arbitrum, optimism (default ethereum)."
  },
  "contract": {
   "type": "string",
   "description": "NFT contract address (0x-prefixed 40-hex)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "BoredApeYachtClub",
  "source": "alchemy-nft-v3",
  "symbol": "BAYC",
  "network": "ethereum",
  "contract": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "tokenType": "ERC721",
  "discordUrl": "https://discord.gg/3P5K3dzgdB",
  "floorPrice": 13.5,
  "description": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs.",
  "externalUrl": "https://boredapeyachtclub.com",
  "openSeaSlug": "boredapeyachtclub",
  "totalSupply": "10000",
  "openSeaImage": "https://...",
  "safelistStatus": "verified",
  "deployerAddress": "0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03",
  "twitterUsername": "BoredApeYC",
  "floorPriceSource": "opensea",
  "deployedBlockNumber": 12287507
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nft-collection-metadata-lookup-e316ed44/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)