{"uid":"cap_xVu2Ue7eKWtcf8srPgwhi","slug":"erc-721-token-ids-by-owner-ethereum-6a108096","name":"ERC-721 Token IDs by Owner (Ethereum)","description":"Call when an agent needs the ERC-721 token ids one wallet owns in an Ethereum collection, via tokenOfOwnerByIndex when enumerable (at most 100). Unsupported enumeration errors and is not billed. No log scan. Send JSON {\"contract\":\"0x1111111111111111111111111111111111111111\",\"owner\":\"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\"}. Exact $0.005 USDC on Base. Try unpaid POST /v1/sandbox/eth-erc721-tokens first.","url":"https://agentshelf.syntexa.ch/v1/eth-erc721-tokens?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"owner":{"type":"string","examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"description":"Wallet whose token ids are listed. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045. At most 100 ids are returned."},"contract":{"type":"string","examples":["0x1111111111111111111111111111111111111111"],"description":"ERC-721 collection on Ethereum mainnet. Example: 0x1111111111111111111111111111111111111111. Enumeration uses tokenOfOwnerByIndex only."}}},"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_iyOqjNzBbIqnfx132tfqk","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 the list of ERC-721 token IDs owned by a wallet address in a given Ethereum collection, using tokenOfOwnerByIndex enumeration (up to 100 IDs).","exampleAgentPrompt":"Can you look up all the ERC-721 token IDs that the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 owns in the NFT collection at contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum mainnet?","exampleUseCases":[{"title":"Check NFT holdings before airdrop","prompt":"I need to know which token IDs in the BAYC contract (0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D) are owned by 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — can you pull the full list for me?"},{"title":"Verify wallet NFT ownership for access control","prompt":"Before granting this user access to our Discord, can you check if wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B actually holds any token IDs in our NFT collection at contract 0x1111111111111111111111111111111111111111?"},{"title":"Portfolio inventory for NFT tracker","prompt":"I'm building an NFT portfolio summary for the wallet 0x1234567890abcdef1234567890abcdef12345678 — can you enumerate all the token IDs they own in the CryptoPunks-compatible collection at 0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB?"}],"resultDescription":"A list of up to 100 ERC-721 token IDs owned by the specified wallet in the given contract, retrieved via the tokenOfOwnerByIndex enumeration method. Non-enumerable contracts return an unsupported error without being billed.","failureModes":["Contract does not implement the ERC-721 Enumerable interface — returns an error and is not billed","Invalid Ethereum address format for contract or owner — rejected with a validation error","Wallet owns more than 100 tokens — only first 100 are returned","Contract address not on Ethereum mainnet — not supported","Network or RPC timeout when querying the chain"],"whenToPreferThis":"Use this endpoint when you need the actual token IDs (not just a balance count) that a wallet holds in a specific ERC-721 collection on Ethereum mainnet, and the contract implements the ERC-721 Enumerable extension (tokenOfOwnerByIndex). It is ideal for ownership verification, portfolio listing, or access-gating workflows where you need the specific token IDs. It is not suitable for non-enumerable contracts, ERC-1155 tokens, or chains other than Ethereum mainnet.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:20:45.856Z","isFirstParty":false,"canonicalSlug":"erc-721-token-ids-by-owner-ethereum-6a108096"}