{"uid":"cap_e_X7YqWgQFBYZriEAjZO7","slug":"agent-data-tools-revmesh2074-workers-dev-ethereum-nft-balance-erc-721-4883d0ef","name":"Ethereum NFT Balance (ERC-721 balanceOf)","description":"How many NFTs of one ERC-721 collection a wallet holds on Ethereum (balanceOf), with the collection's name and symbol. Use to check a holder before a token-gated action or to see whether a wallet still holds a collection; for who holds one token id use eth_nft_owner. Both inputs are 0x addresses; a missing contract or one that is not ERC-721 is 422, uncharged.","url":"https://agent-data-tools.revmesh2074.workers.dev/eth/nft-balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["contract","address"],"properties":{"address":{"type":"string","description":"0x wallet address"},"contract":{"type":"string","description":"0x ERC-721 collection contract address"}}},"responseSchema":{"type":"object","properties":{"name":{"type":"string"},"chain":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"balance":{"type":"string"},"chainId":{"type":"number"},"contract":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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_hqry_tNBTcEh-LfcRLOWK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Returns how many NFTs of a specific ERC-721 collection a wallet address holds on Ethereum mainnet, along with the collection name and symbol.","exampleAgentPrompt":"Check how many NFTs the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds in the Bored Ape Yacht Club collection (contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D) on Ethereum.","exampleUseCases":[{"title":"Token-gated access verification","prompt":"Before letting this user into the members-only Discord channel, check whether their Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds any NFTs from the Azuki collection at contract 0xED5AF388653567Af2F388E6224dC7C4b3241C544."},{"title":"NFT holder eligibility check for airdrop","prompt":"I need to airdrop tokens only to wallets that still hold at least one NFT from the Doodles collection (contract 0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e on Ethereum) — can you check if wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B qualifies?"},{"title":"Portfolio NFT count lookup","prompt":"How many NFTs does the wallet 0x1234567890abcdef1234567890abcdef12345678 currently hold from the CloneX collection at Ethereum contract 0x49cF6f5d44E70224e2E23fDcdd2C053F30aDA28b?"}],"resultDescription":"A JSON object containing the wallet's NFT balance (as a string integer), the collection's name and symbol, the chain name ('ethereum'), the chainId (1), and echoed-back wallet and contract addresses. Returns 404 if the contract address doesn't exist, 422 if the contract is not ERC-721 compliant; both error cases are uncharged.","failureModes":["404 if the contract address does not exist on Ethereum mainnet (not charged)","422 if the contract exists but does not implement ERC-721 (not charged)","Invalid 0x address format may result in a 400 or error response","Network or RPC timeouts on Ethereum may cause transient failures"],"whenToPreferThis":"Use this endpoint when you need to know how many NFTs a wallet holds across an entire ERC-721 collection on Ethereum mainnet (balanceOf). Prefer this over eth_nft_owner when you want the total count for a wallet rather than who owns a specific token ID. Choose this Ethereum-specific endpoint over the Base, Polygon, or Optimism variants when the collection is deployed on Ethereum mainnet.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-19T23:39:26.817Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-ethereum-nft-balance-erc-721-4883d0ef"}