{"uid":"cap_iRkyIAFY1o181YKGAJHtp","slug":"zerion-91ff6233","name":"Zerion NFT Search and List","description":"Search/list NFTs","url":"https://api.zerion.io/v1/nfts/?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"currency":{"type":"string","description":"Fiat currency for prices and values (defaults to usd)"},"filter[references]":{"type":"string","description":"Comma-separated NFT references, each `<chain_id>:<contract_address>:<token_id>`"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Resource ID."},"type":{"type":"string","description":"Resource type."},"attributes":{"type":"object","description":"Resource attributes; see https://developers.zerion.io"}}},"description":"Array of JSON:API resource objects."},"links":{"type":"object","description":"Self and pagination links."}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"<resource id>","type":"<resource type>","attributes":{}}],"links":{"self":"https://api.zerion.io/v1/..."}}},"example":{"request":{"filter[references]":"ethereum:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D:1"},"response":{"data":[{"id":"ethereum:0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d:1","type":"nfts","attributes":{"flags":{"is_spam":false},"metadata":{"tags":[],"content":{"detail":{"url":"https://nft-cdn.alchemy.com/eth-mainnet/65558a4d0c5b0c56fbc50bf03f55e3fa"},"preview":{"url":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-mainnet/65558a4d0c5b0c56fbc50bf03f55e3fa"}},"attributes":[{"key":"Mouth","value":"Grin"},{"key":"Clothes","value":"Vietnam Jacket"},{"key":"Background","value":"Orange"},{"key":"Eyes","value":"Blue Beams"},{"key":"Fur","value":"Robot"}]},"token_id":"1","interface":"ERC721","market_data":{"prices":{"floor":16032.288000000002}},"external_links":[],"contract_address":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"},"relationships":{"chain":{"data":{"id":"ethereum","type":"chains"},"links":{"related":"https://api.zerion.io/v1/chains/ethereum"}},"nft_collection":{"data":{"id":"79584","type":"nft_collections"}}}}],"links":{"self":"https://api.zerion.io/v1/nfts/?currency=usd&filter%5Breferences%5D=ethereum%3A0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d%3A1"}}},"exampleRequest":{"filter[references]":"ethereum:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D:1"},"tags":["x402"],"displayCostAmount":"0.010000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.010000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1i4GdHvcMorg1pNlJDwDJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and list NFTs across wallets and collections on the Zerion DeFi platform","exampleAgentPrompt":"Show me all the NFTs in wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum using Zerion.","exampleUseCases":[{"title":"Portfolio overview for web3 investor","prompt":"Can you pull up all the NFTs I'm holding across Ethereum and Polygon? I need to see the floor prices and metadata to understand my collection's current value."},{"title":"Discover rare traits in collection","prompt":"Show me all the NFTs in the Pudgy Penguins collection and help me identify which ones have the rarest traits so I know what I should be looking to collect."},{"title":"Cross-chain wallet audit","prompt":"I want to see every NFT across all my wallets on different chains - can you search my addresses and give me a complete list with images and metadata so I can catalog everything I own?"}],"resultDescription":"A list of NFT objects including token ID, name, collection name, image URL, traits, chain, floor price, and other metadata for the queried wallet or collection.","failureModes":["Invalid or malformed wallet address returns a 400 error","Unsupported chain ID returns an error or empty result","Payment not included or x402 payment failure returns a 402 status","Rate limiting returns a 429 error","No NFTs found for the given parameters returns an empty list","Network timeout on large wallet queries"],"whenToPreferThis":"Use this endpoint when you need to retrieve or search NFT holdings for a specific wallet or browse NFTs within the Zerion ecosystem, especially when working in a DeFi/web3 context and needing rich metadata including floor prices and traits across multiple EVM chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T00:48:33.318Z","isFirstParty":false,"canonicalSlug":"zerion-91ff6233"}