{"uid":"cap__Z8Y_oGjJzRZyAygOv1_7","slug":"skills-onesource-io-5a52cfdd","name":"ERC1155 Token Balance Checker","description":"ERC1155 token balance via balanceOf (eth_call) - how many copies of a token_id a wallet holds","url":"https://skills.onesource.io/api/chain/erc1155-balance","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"account":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"network":{"enum":["ethereum","sepolia","avax","megaeth","megaeth-testnet","base"],"type":"string","default":"ethereum"},"contract":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"token_id":{"type":"string","pattern":"^[0-9]+$"}}},"responseSchema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["account","balance","token_id","contract_address"],"properties":{"account":{"type":"string"},"balance":{"type":"string"},"token_id":{"type":"string"},"contract_address":{"type":"string"}}},"meta":{"type":"object","required":["endpoint","request_id"],"properties":{"endpoint":{"type":"string"},"request_id":{"type":"string"}}}}},"example":{"request":{"account":"0x1234567890123456789012345678901234567890","network":"sepolia","contract":"0x0987654321098765432109876543210987654321","token_id":"1"},"response":{"data":{"account":"0x1234567890123456789012345678901234567890","balance":"0","token_id":"1","contract_address":"0x0987654321098765432109876543210987654321"},"meta":{"endpoint":"/api/chain/erc1155-balance","request_id":"c6d323c1a54648ff"}}},"exampleRequest":{"account":"0x1234567890123456789012345678901234567890","network":"sepolia","contract":"0x0987654321098765432109876543210987654321","token_id":"1"},"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1XraDM8BfjlP1FBAjTNOU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns how many copies of a specific ERC1155 token ID a wallet address holds, via eth_call on supported EVM chains","exampleAgentPrompt":"How many copies of token ID 7 does wallet 0x1234567890123456789012345678901234567890 hold for ERC1155 contract 0x0987654321098765432109876543210987654321 on Base?","exampleUseCases":[{"title":"Verify membership NFT ownership","prompt":"Check if wallet 0x8f3cf7ad23cd3cadbd9735aff958023d60c95600 holds any copies of token ID 1 from the membership contract 0x2c1ba2d3715eb694515a5fc23ef28fbc9a7e3da9 on Ethereum."},{"title":"Validate gaming item inventory","prompt":"How many units of token ID 3 does address 0x742d35cc6634C0532925a3b844Bc9e7595f42e01 own from our game items contract 0x495f947276749Ce646f68AC8c248420045cb7b5e on Base?"},{"title":"Check multi-edition collectible allocation","prompt":"I need to verify that wallet 0x5a0b54d5dc17e0aadc383d2db43b0a0d3e029c4c has at least 5 copies of token ID 12 from the collectibles contract 0x1234567890abcdef1234567890abcdef12345678 on Avalanche."}],"resultDescription":"Returns the wallet's balance (number of copies held) of the specified ERC1155 token ID, along with the account address, contract address, and token ID echoed back for confirmation.","failureModes":["Invalid wallet address format returns 400 error","Invalid contract address returns 400 error","Token ID must be a numeric string — non-numeric values rejected","Unsupported network name returns validation error","Contract address that is not an ERC1155 contract may return 0 or RPC error","RPC node unavailability causes 503 or timeout"],"whenToPreferThis":"Use this endpoint when you need to check how many units of a specific ERC1155 token ID a wallet owns on Ethereum, Base, Avalanche, Sepolia, or MegaETH. Prefer this over ERC20/ERC721 balance endpoints when dealing with semi-fungible or multi-edition NFT tokens (ERC1155 standard).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:45:47.810Z","isFirstParty":false}