{"uid":"cap_sSVFixmYAFmq_1FdS_-QB","slug":"erc721-token-holdings-lookup-3df71b57","name":"ERC721 Token Holdings Lookup","description":"Company intelligence, KYB, sanctions screening and monitoring for AI agents. Pay per call with x402 and USDC on Base. No API keys. Explore free samples.","url":"https://api.axiomworks.co.uk/chain/erc721-tokens?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":["contract","address"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","description":"EVM chain (default base)"},"limit":{"type":"string","description":"Max token_ids (default 50, max 100)"},"wallet":{"type":"string","description":"Alias for address (owner wallet)"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Owner wallet"},"network":{"type":"string","description":"Alias for chain (onesource-compatible)"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC721 collection"}}}},"additionalProperties":false}}},"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_Hq8FnFKnsqr5ZeZNwPY85","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 all ERC721 NFT token IDs held by a specific wallet address for a given collection contract on EVM chains","exampleAgentPrompt":"Can you list all the token IDs from the Bored Ape Yacht Club contract (0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D) that wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B currently holds on Ethereum?","exampleUseCases":[{"title":"NFT gating and access verification","prompt":"Check if wallet 0x1234567890abcdef1234567890abcdef12345678 owns any tokens from the collection at contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum — I need to verify they qualify for token-gated access."},{"title":"Portfolio NFT inventory audit","prompt":"Pull up to 100 token IDs from the Azuki contract 0xED5AF388653567Af2F388E6224dC7C4b3241C544 that are owned by wallet 0xdEAD000000000000000042069420694206942069 on Ethereum so I can audit their NFT holdings."},{"title":"On-chain NFT ownership snapshot","prompt":"List all ERC721 tokens the wallet 0xAbCdEf1234567890AbCdEf1234567890AbCdEf12 holds in the collection at 0xa7d8d9ef8D8Ce8992Df33D8b8CF4Aebabd5bD27 on Arbitrum — I need a snapshot for a report."}],"resultDescription":"A list of ERC721 token IDs owned by the specified wallet address within the given collection contract, up to the requested limit (default 50, max 100), filtered by chain. Typically includes token IDs as an array and ownership metadata for each token.","failureModes":["Invalid wallet or contract address format (must be 0x + 40 hex chars) returns validation error","Contract address is not an ERC721 contract — may return empty results or error","Unsupported chain value returns enum validation error","Wallet holds no tokens in the collection — returns empty list","Rate limiting or RPC node timeout for high-traffic chains","Limit exceeding 100 is clamped or rejected"],"whenToPreferThis":"Use this endpoint when you need to enumerate which specific token IDs from a known ERC721 collection a wallet owns, without needing full metadata like images or attributes. Prefer this over the tokenURI/metadata endpoint when you only need ownership enumeration rather than resolved metadata. Ideal for NFT gating checks, inventory snapshots, and ownership verification on Base, Ethereum, Arbitrum, Optimism, or Polygon.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T18:46:51.257Z","isFirstParty":false,"canonicalSlug":"erc721-token-holdings-lookup-3df71b57"}