{"uid":"cap_0v_uvDXdXLmlZQCo4X781","slug":"erc-1155-token-balance-uri-lookup-multi-chain-3b3d8e03","name":"ERC-1155 Token Balance & URI Lookup (Multi-Chain)","description":"How many copies of an ERC-1155 token id a wallet holds (balanceOf), with the token URI. Works on Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic and Unichain.","url":"https://api.vextorium.com/erc1155-saldo-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"red":{"enum":["base","ethereum","arbitrum","optimism","polygon","bnb","avalanche","gnosis","linea","scroll","sonic","unichain"],"type":"string","description":"Chain (default base)"},"contrato":{"type":"string"},"token_id":{"type":"string"},"direccion":{"type":"string"}}},"responseSchema":{"type":"json","example":{"red":"ethereum","uri":"https://nftdata.parallelnft.com/api/parallel-alpha","wallet":"0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf","cantidad":0,"contrato":"0x76BE3b62873462d2142405439777e971754E8E77","token_id":"10373"}},"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_XL5qkblhYncYysxB8Gdr5","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":"Returns the number of copies of a specific ERC-1155 token ID held by a wallet address, plus the token URI, across 12 supported blockchains.","exampleAgentPrompt":"How many copies of ERC-1155 token ID 10373 does wallet 0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf hold on the contract 0x76BE3b62873462d2142405439777e971754E8E77 on Ethereum, and what's the token URI?","exampleUseCases":[{"title":"NFT ownership gate check","prompt":"Can you check how many copies of token ID 42 the wallet 0xABC123...def holds in the contract 0x1234...5678 on Polygon? I need to know if they hold at least one to grant them access."},{"title":"Gaming item inventory lookup","prompt":"Tell me how many of item token ID 7 from the game contract 0xDEAD...BEEF on Arbitrum are in wallet 0x9876...FEDC, and grab the token URI so I can pull the item metadata."},{"title":"Multi-chain ERC-1155 balance audit","prompt":"Check the ERC-1155 balance of wallet 0xAAAA...BBBB for token ID 1 on contract 0xCCCC...DDDD — try it on Base first and give me the quantity and the metadata URI."}],"resultDescription":"Returns a JSON object containing the chain name (red), the wallet address (wallet), the contract address (contrato), the queried token ID (token_id), the number of tokens held (cantidad, as a number), and the token metadata URI (uri). All fields can be null if data is unavailable.","failureModes":["Invalid wallet address format returns null or error","Unsupported chain or misspelled chain enum returns an error","Contract address is not an ERC-1155 contract — balance may return null or unexpected result","Token ID does not exist on the contract — cantidad returns 0","Token URI is null if the contract does not implement the URI function","Network timeouts on RPC calls for less common chains like Gnosis or Unichain"],"whenToPreferThis":"Use this endpoint when you need to check ERC-1155 multi-edition NFT or gaming token balances across 12 major EVM chains in a single API call, and also want the token's metadata URI in the same response. Prefer this over a generic blockchain RPC call when you need a hosted, multi-chain solution without managing your own node infrastructure, and when the $0.003 per-call cost is acceptable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:52:21.314Z","isFirstParty":false,"canonicalSlug":"erc-1155-token-balance-uri-lookup-multi-chain-3b3d8e03"}