{"uid":"cap_7kSaKhcRpeg04cWpBf0Pp","slug":"saylor-innovations-erc-721-token-ownership-lookup-a949c0af","name":"Saylor Innovations ERC-721 Token Ownership Lookup","description":"NFT count and token ids a wallet owns in one ERC-721 collection on 16 EVM chains, listed through the Enumerable extension where supported.","url":"https://saylorinnovations.com/api/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","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["chain","owner","collection"],"properties":{"chain":{"type":"string","description":"chain name (ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, mantle, blast, sonic, celo, berachain, unichain) or chain id"},"limit":{"type":"string","description":"token ids to return, 1 to 50 (default 25)"},"owner":{"type":"string","description":"the wallet to inspect"},"collection":{"type":"string","description":"the ERC-721 collection contract"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["chain","chain_id","owner","collection","balance","enumerable","token_ids","source"],"properties":{"name":{"type":["string","null"],"description":"collection name"},"note":{"type":"string","description":"listing status"},"chain":{"type":"string","description":"the chain name that was queried"},"owner":{"type":"string","description":"wallet that was inspected"},"source":{"type":"string","description":"where the data was read from"},"symbol":{"type":["string","null"],"description":"collection symbol"},"balance":{"type":"number","description":"number of tokens the wallet holds in the collection"},"chain_id":{"type":"number","description":"EIP-155 chain id of that network"},"token_ids":{"type":"array","items":{"type":"string"},"description":"token ids held (up to limit)"},"truncated":{"type":"boolean","description":"true when more tokens are held than listed"},"checked_at":{"type":"string","description":"Time the check was run (UTC)"},"collection":{"type":"string","description":"the ERC-721 contract"},"enumerable":{"type":"boolean","description":"true when the contract supports ERC-721 Enumerable so token ids can be listed"}},"additionalProperties":true},"description":{"type":"string"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CPkXpcfz-b38AwpEclPBQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the NFT count and token IDs a wallet owns in a specific ERC-721 collection across 16 EVM-compatible chains, using the Enumerable extension where available.","exampleAgentPrompt":"How many NFTs does wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 own in the Bored Ape Yacht Club collection (0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D) on Ethereum, and list me their token IDs?","exampleUseCases":[{"title":"NFT portfolio audit for a wallet","prompt":"Can you check how many tokens wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B holds in the Azuki collection at 0xED5AF388653567Af2F388E6224dC7C4b3241C544 on Ethereum, and list all the token IDs it owns?"},{"title":"Verify NFT ownership for access control","prompt":"I need to confirm whether wallet 0x1234567890abcdef1234567890abcdef12345678 actually owns any tokens in the collection contract 0xBd3531dA5CF5857e7CfAA92426877b022e612cf8 on Polygon — can you check the balance and token IDs?"},{"title":"Track NFT holdings on Base chain","prompt":"Look up all the token IDs that wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 owns in the ERC-721 collection 0x7d5861CfE1C74aaa0999B7e2651Bf2eb5E5B9cD3 on Base, up to 50 tokens."}],"resultDescription":"A JSON object containing the queried chain name and chain ID, the wallet address, the collection contract address, the total NFT balance (count), an enumerable boolean indicating whether the contract supports ERC-721 Enumerable, an array of owned token IDs (up to the requested limit), a truncated flag if more tokens exist than listed, the collection name and symbol if available, and the data source used.","failureModes":["Invalid or unsupported chain name/ID returns an error","Non-ERC-721 contract address may return zero balance or an error","Wallet address with no holdings returns balance of 0 and empty token_ids array","Collections that do not implement ERC-721 Enumerable return enumerable:false with empty token_ids even if balance > 0","Malformed wallet or contract address returns a validation error","Rate limiting or RPC node issues may cause intermittent failures"],"whenToPreferThis":"Use this endpoint when you need to enumerate the specific token IDs owned by a wallet in a given ERC-721 NFT collection on any of 16 supported EVM chains. It is especially useful when the collection supports the Enumerable extension, enabling full token ID listing. Prefer this over general blockchain explorers when you want a clean, structured JSON response with balance and token ID list in a single call, and when you need to support non-Ethereum chains like Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, Gnosis, Linea, Scroll, Mantle, Blast, Sonic, Celo, Berachain, or Unichain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-19T00:33:55.328Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-erc-721-token-ownership-lookup-a949c0af"}