{"uid":"cap_ZSDfs_ivXLhuSWI6lLn7p","slug":"base-erc1155-balance-c9cc20f3","name":"base-erc1155-balance","description":"ERC1155 multi-token balance for a wallet and token id on Base mainnet via balanceOf(address,uint256).","url":"https://x402.agentindex.world/base/erc1155-balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","title":"Token"},"wallet":{"type":"string","title":"Wallet"},"token_id":{"type":"integer","title":"Token Id","minimum":0}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.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_ph-t4xg3VLT61chUUQKs8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Queries the ERC-1155 multi-token balance for a specific wallet address and token ID on Base mainnet via the balanceOf(address,uint256) contract call.","exampleAgentPrompt":"Check how many of token ID 7 from ERC-1155 contract 0xAbC...123 are held by wallet 0xDeF...456 on Base mainnet.","exampleUseCases":[{"title":"Gate access by token ownership","prompt":"Does wallet 0xDeF...456 hold at least 1 of token ID 3 from the ERC-1155 contract at 0xAbC...123 on Base? I want to know before letting them into the members-only channel."},{"title":"Game item inventory check","prompt":"How many of item token ID 99 does player wallet 0x111...aaa have in the ERC-1155 contract 0x222...bbb on Base mainnet? I need to know their sword count before they can enter the tournament."},{"title":"Audit ERC-1155 holdings","prompt":"Pull the balance of token ID 0 for wallet 0xFFF...000 from the ERC-1155 contract 0x333...ccc on Base — I'm auditing how many edition-one passes this address holds."}],"resultDescription":"Returns the integer quantity of the specified ERC-1155 token ID held by the given wallet address, as returned by the on-chain balanceOf(address,uint256) function on Base mainnet.","failureModes":["Invalid wallet address format returns an error","Invalid or non-existent token contract address returns an error or zero balance","Token ID does not exist on the contract may return zero rather than an error","Network congestion on Base may cause delayed or failed RPC reads","Negative or non-integer token_id rejected by schema validation"],"whenToPreferThis":"Use this endpoint when you need to read the ERC-1155 balance of a specific token ID for a wallet on Base mainnet specifically — especially for semi-fungible tokens (SFTs), gaming items, or multi-edition NFTs where one contract manages many token types. Prefer this over ERC-20 or ERC-721 balance endpoints when the contract follows the ERC-1155 standard with distinct token IDs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:35:19.916Z","isFirstParty":false,"canonicalSlug":"base-erc1155-balance-c9cc20f3"}