{"uid":"cap_BRh9IXLwGeEnxsMgVLk8E","slug":"vextorium-erc-721-wallet-token-ids-lookup-dd68cf6e","name":"Vextorium ERC-721 Wallet Token IDs Lookup","description":"Token ids of an ERC-721 collection held by a wallet (tokenOfOwnerByIndex on enumerable collections) and the total count. Works on Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic and Unichain.","url":"https://api.vextorium.com/nft-de-wallet-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"red":{"enum":["base","ethereum","arbitrum","optimism","polygon","bnb","avalanche","gnosis","linea","scroll","sonic","unichain"],"type":"string","description":"Chain (default base)"},"limite":{"type":"integer"},"contrato":{"type":"string"},"direccion":{"type":"string"}}},"responseSchema":{"type":"json","example":{"red":"ethereum","wallet":"0x46EFbAedc92067E6d60E84ED6395099723252496","cantidad":1,"coleccion":"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D","token_ids":["1"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yknCViRM-Ag71hj5op1pz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all ERC-721 token IDs held by a wallet address in a given NFT collection, plus the total count, across 12 EVM chains","exampleAgentPrompt":"Can you tell me which token IDs from the BAYC collection (0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D) are held by the wallet 0x46EFbAedc92067E6d60E84ED6395099723252496 on Ethereum, and how many total does it own?","exampleUseCases":[{"title":"NFT portfolio audit for a wallet","prompt":"Show me all the token IDs from the Azuki collection (contract 0xED5AF388653567Af2F388E6224dC7C4b3241C544) that the wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B holds on Ethereum, and tell me how many there are total."},{"title":"Gating check for token-gated access","prompt":"I need to verify whether the wallet 0x1234567890abcdef1234567890abcdef12345678 owns any tokens from the NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Base — get me the list of token IDs they hold."},{"title":"Cross-chain NFT holdings discovery","prompt":"What token IDs from the NFT contract 0xa7d8d9ef8D8Ce8992Df33D8b8CF4Aebabd5bD270 does the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 hold on Polygon, and what's the total count?"}],"resultDescription":"Returns a JSON object containing the blockchain name, the queried wallet address, the NFT collection contract address, the total count of tokens owned (cantidad), and an array of token ID strings (token_ids) held by that wallet in that collection.","failureModes":["Collection contract is not enumerable (does not implement ERC-721Enumerable), causing the tokenOfOwnerByIndex calls to fail","Invalid wallet or contract address format returns an error","Unsupported chain specified outside the 12 supported networks","Wallet holds no tokens from the collection — returns cantidad: 0 and empty token_ids array","Network RPC timeout or congestion causing delayed or failed response","Payment failure via x402 protocol if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to enumerate specific token IDs from a known ERC-721 collection owned by a wallet, especially on enumerable collections across any of the 12 supported EVM chains (Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic, Unichain). Prefer this over generic blockchain explorers when you need structured, agent-ready JSON output with both the count and full token ID list in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:40:36.114Z","isFirstParty":false,"canonicalSlug":"vextorium-erc-721-wallet-token-ids-lookup-dd68cf6e"}