{"uid":"cap_i0tUHgJGmfkPC0NpdfX9G","slug":"agenttools-nft-wallet-portfolio-lookup-c624185e","name":"AgentTools NFT Wallet Portfolio Lookup","description":"Look up an address's NFT portfolio across collections: each collection held, quantity owned, sorted by size. The enrichment endpoint for agents profiling wallets — pairs with wallet-snapshot for the full picture. Use this when an agent needs to every NFT collection a wallet holds, in one call.","url":"https://agentstoolshub.com/api/v1/nft/wallet-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","required":["address"],"properties":{"chain":{"enum":["ethereum","base"],"type":"string","description":"Chain"},"limit":{"type":"number","description":"Max collections"},"address":{"type":"string","description":"Wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f3LNzYQcIReI1GUbALhRo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all NFT collections held by a wallet address on Ethereum or Base, sorted by quantity owned per collection.","exampleAgentPrompt":"Can you pull up all the NFT collections held by wallet 0x1234...abcd on Ethereum and show me how many tokens they own in each collection, sorted by quantity?","exampleUseCases":[{"title":"Whale wallet NFT profiling","prompt":"I want to understand the NFT portfolio of this wallet — 0xABC...123 on Ethereum. Show me every collection they hold and how many tokens they own in each, sorted from most to least."},{"title":"Due diligence before NFT trade","prompt":"Before I do a deal with this person, can you check what NFT collections their Base wallet 0xDEF...456 holds? I want to see all collections and quantities to know what they actually own."},{"title":"Agent dashboard wallet snapshot","prompt":"For the wallet 0x789...GHI on Ethereum, fetch all NFT collections they hold and include the count per collection — I only need the top 10 collections by size."}],"resultDescription":"A list of NFT collections held by the queried wallet address, each entry including the collection name/identifier and the quantity of tokens owned, sorted in descending order by quantity. Supports filtering by chain (ethereum or base) and an optional limit on the number of collections returned.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Unsupported chain value outside of 'ethereum' or 'base' returns a validation error","Wallet with no NFTs returns an empty collection list","Rate limiting or payment failure (x402) if credits are insufficient","Network or upstream indexer timeout resulting in a 503 or partial response"],"whenToPreferThis":"Use this endpoint when an agent needs a complete, sorted breakdown of all NFT collections held by a specific wallet in a single call, particularly for wallet profiling, due diligence, or enrichment workflows on Ethereum or Base. Prefer this over generic blockchain explorers when you need structured, agent-ready data without scraping. Pair with a wallet-snapshot endpoint for a full financial picture.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:50:07.379Z","isFirstParty":false,"canonicalSlug":"agenttools-nft-wallet-portfolio-lookup-c624185e"}