{"uid":"cap_MZGRm3hfemTLI3P9lTR-J","slug":"agent-data-tools-revmesh2074-workers-dev-arbitrum-nft-balance-balanceof-bbe0d3b8","name":"Arbitrum NFT Balance (balanceOf)","description":"How many NFTs of one ERC-721 collection a wallet holds on Arbitrum One (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 arb_nft_owner. Both inputs are 0x addresses; a missing contract is 404, a contract that is not ERC-721 422, both uncharged.","url":"https://agent-data-tools.revmesh2074.workers.dev/arb/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":[],"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_0fC-R6CfNBGKP2FVY8CuX","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 the number of ERC-721 NFTs a wallet holds in a specific collection on Arbitrum One, plus the collection name and symbol.","exampleAgentPrompt":"Check how many NFTs wallet 0xAbC...123 holds in the Arbitrum ERC-721 collection at contract 0xDef...456 — I need to know if they qualify for token-gated access.","exampleUseCases":[{"title":"Token-gate before granting Discord role","prompt":"Before giving this user the holder role, check if their wallet 0xAbC...123 holds at least one NFT from our Arbitrum collection at contract 0xDef...456."},{"title":"Snapshot holder eligibility for airdrop","prompt":"I need to verify whether wallet 0x111...aaa still holds any NFTs from the Azuki-style collection at 0x222...bbb on Arbitrum — we're doing an airdrop only to current holders."},{"title":"Dashboard showing user's Arbitrum NFT count","prompt":"For my user's profile page, fetch how many NFTs from the collection at contract 0x999...fff their wallet 0x888...eee currently holds on Arbitrum One, including the collection name and symbol."}],"resultDescription":"Returns a JSON object with the wallet's NFT balance (as a string), the collection's name and symbol, the chain name ('arbitrum'), the chainId (42161), and the queried wallet and contract addresses. A 404 means the contract does not exist; a 422 means the contract exists but is not ERC-721; neither error is charged.","failureModes":["404 — contract address not found on Arbitrum One (not charged)","422 — contract exists but does not implement ERC-721 interface (not charged)","Invalid 0x address format may cause a 400 or error response","Network/RPC timeout from Arbitrum node","Wallet has zero balance — returns balance: '0', not an error"],"whenToPreferThis":"Use this endpoint when you need the aggregate NFT count a wallet holds in a given ERC-721 collection on Arbitrum One — ideal for token-gating checks, holder verification, and dashboard displays. If you need to find who owns a specific token ID rather than a count, use the arb_nft_owner endpoint instead. Prefer this over generic blockchain RPC calls when you also want the collection name and symbol alongside the balance in one call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T05:40:05.132Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-arbitrum-nft-balance-balanceof-bbe0d3b8"}