🎒Wallet NFT Portfolio
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.
Worked examples
vitalik.eth NFT portfolio
GET /api/v1/nft/wallet-nfts?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=ethereum&limit=20
Result: 50 collections · 50 NFTs total
Base portfolio
GET /api/v1/nft/wallet-nfts?address=0x8a0F2b0a6C82D1c54B16E2e4DEcd18fF0802b0f6&chain=base&limit=10
Result: 1 collection · 1 NFTs total
Machine API (x402)
$0.002 / callThis tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol — no accounts, no API keys.
GET /api/v1/nft/wallet-nfts?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=ethereum&limit=20 HTTP/1.1
Host: agenttools-hub.vercel.app
→ 402 (payment required, instructions in headers)
→ 200 (after X-PAYMENT header; JSON body below)
{
"tool": "nft/wallet-nfts",
"input": {"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chain":"ethereum","limit":20},
"result": { "value": 50, "answer": "50 collections · 50 NFTs total" }
}Agent docs: /llms.txt · OpenAPI spec · integration guide
About this tool
The enrichment endpoint for wallet profiling: given any address, return every NFT collection it holds with quantities, sorted by size. Combined with wallet-snapshot (balance and activity) it completes the 'who is this address' picture.
Frequently asked questions
Does it include item-level detail?
It returns per-collection quantities. Item-level metadata (images, traits) would multiply the payload — available as a follow-up parameter if needed.