{"uid":"cap_fTiorbdyO9dtt7UXi_E7N","slug":"erc-1155-token-balance-query-c39b1761","name":"ERC-1155 Token Balance Query","description":"Use when you need how many copies of an ERC-1155 token id an address holds on Base, Ethereum, Arbitrum, Optimism or Polygon, via balanceOf(account, id). Read-only public data.","url":"https://biosfera.46-62-215-147.sslip.io/o/erc1155-balance?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","token_id"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"token_id":{"type":"string","pattern":"^[0-9]{1,78}$"}},"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.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FzQCjRq_pSYDO8w7RD1TE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the number of copies of a specific ERC-1155 token ID held by a given address on Base, Ethereum, Arbitrum, Optimism, or Polygon.","exampleAgentPrompt":"How many copies of ERC-1155 token ID 7 does wallet 0xAbCd1234567890abcdef1234567890abcdef1234 hold on the contract 0xDeAd0000000000000000000000000000DeAdBeEf on Base?","exampleUseCases":[{"title":"NFT edition ownership verification","prompt":"Check how many copies of ERC-1155 token ID 1 the wallet 0x1111111111111111111111111111111111111111 owns on contract 0x2222222222222222222222222222222222222222 on Ethereum — I want to know if they qualify for a multi-copy holder reward."},{"title":"Game item inventory lookup","prompt":"How many of game item token ID 99 does player wallet 0xAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA hold in the contract 0xBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB on Polygon? I need the count to calculate their in-game crafting resources."},{"title":"Cross-chain token balance comparison","prompt":"Tell me how many copies of ERC-1155 token ID 3 wallet 0xCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC holds in contract 0xDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD on Arbitrum — I'm auditing balances across chains."}],"resultDescription":"Returns the integer count of how many copies of the specified ERC-1155 token ID the given address holds in the given contract on the selected chain, equivalent to calling balanceOf(account, id) on-chain.","failureModes":["Invalid Ethereum address format (must match 0x followed by 40 hex chars) returns a validation error","Unsupported chain value returns an enum validation error","Token ID out of range or non-numeric returns a validation error","Contract address does not implement ERC-1155 may return zero or an error","Network timeout or RPC node unavailability returns a service error","Missing required query parameters returns a 400-level error"],"whenToPreferThis":"Choose this endpoint when you specifically need the balance of an ERC-1155 (multi-token standard) token — where a single address can hold multiple copies of the same token ID. Use this instead of ERC-721 ownership endpoints (which only track single NFT ownership) or ERC-20 balance endpoints. Ideal for semi-fungible tokens like game items, event tickets, or edition-based NFTs where quantity per wallet matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:30:06.783Z","isFirstParty":false,"canonicalSlug":"erc-1155-token-balance-query-c39b1761"}