{"uid":"cap_lykahO6np6Ec0xdDaBFXC","slug":"erc-721-tokens-of-owner-lookup-ab906324","name":"ERC-721 Tokens Of Owner Lookup","description":"Use when you need which token ids of an ERC-721 collection an address owns on Base, Ethereum, Arbitrum, Optimism or Polygon. Works for enumerable collections (tokenOfOwnerByIndex); returns up to 50 ids per page with the total balance, and says when the collection is not enumerable.","url":"https://biosfera.46-62-215-147.sslip.io/o/erc721-tokens-of-owner?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":["chain","contract","address"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string"},"offset":{"type":"integer","maximum":100000,"minimum":0},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__SoOWYG3drSDNE-SCtBiA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the token IDs of an ERC-721 NFT collection owned by a specific wallet address on Base, Ethereum, Arbitrum, Optimism, or Polygon, with pagination and total balance.","exampleAgentPrompt":"Which token IDs from the ERC-721 collection at 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D does the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 own on Ethereum?","exampleUseCases":[{"title":"NFT Portfolio audit for a wallet","prompt":"List all the token IDs from the Azuki NFT collection at 0xED5AF388653567Af2F388E6224dC7C4b3241C544 that the wallet 0xAbCdEf1234567890AbCdEf1234567890AbCdEf12 holds on Ethereum."},{"title":"Gate access by NFT ownership","prompt":"Check if wallet 0x1234567890abcdef1234567890abcdef12345678 owns any tokens from the ERC-721 contract 0xBd3531dA5CF5857e7CfAA92426877b022e612cf8 on Base, and tell me which token IDs they have."},{"title":"Display user NFT collection in app","prompt":"Show me the first 50 token IDs from the Polygon NFT contract 0x2953399124F0cBB46d2CbACD364879b58D618ea5 that belong to address 0xABCDEF1234567890abcdef1234567890abcdef99 on Polygon, starting from offset 0."}],"resultDescription":"Returns a paginated list of up to 50 token IDs owned by the specified address within the given ERC-721 contract, along with the total balance (count of tokens owned). If the collection does not implement the enumerable extension (tokenOfOwnerByIndex), the response indicates that enumeration is not supported.","failureModes":["Collection is not enumerable — response states enumeration is unsupported","Invalid or non-checksummed wallet/contract address — returns validation error","Unsupported chain value — returns error for chains outside the allowed enum","Offset out of range — no results returned if offset exceeds total balance","Network or RPC timeout — transient failure with no token data returned","Address owns zero tokens in the collection — returns empty list with balance 0"],"whenToPreferThis":"Use this endpoint when you need to enumerate specific token IDs an address owns within a known ERC-721 contract on Base, Ethereum, Arbitrum, Optimism, or Polygon. It is the right choice when you need paginated token ID lists (not just balances) and when the collection implements the ERC-721 Enumerable extension. Prefer this over a general NFT indexer when you want lightweight, on-chain verified ownership data per collection without relying on third-party NFT databases.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:48:09.672Z","isFirstParty":false,"canonicalSlug":"erc-721-tokens-of-owner-lookup-ab906324"}