{"uid":"cap_zSn9r7oTHZtBYgTAcMSbr","slug":"nft-collection-metadata-lookup-e316ed44","name":"NFT Collection Metadata Lookup","description":"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.","url":"https://agent402.tools/api/nft-collection","method":"POST","headers":{},"bodySchema":{"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)."}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6pzSmh-iwIrP_5jBCD2wg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:14:05.681Z","isFirstParty":false}