{"uid":"cap_LYm70H7hX8ItysYB-OLWX","slug":"vextorium-erc-1155-balance-lookup-06c6ed77","name":"Vextorium ERC-1155 Balance Lookup","description":"558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.","url":"https://api.vextorium.com/v1/erc1155-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string"},"network":{"enum":["base","ethereum","arbitrum","optimism","polygon","bnb","avalanche","gnosis","line","scroll","sonic","unichain"],"type":"string","description":"Chain (default base)"},"contract":{"type":"string"},"token_id":{"type":"string"}}},"responseSchema":{"type":"json","example":{"uri":"https://nftdata.parallelnft.com/api/parallel-alpha","amount":0,"wallet":"0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf","network":"ethereum","contract":"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_i6rFK6GhTMx6Fnvm_e4m4","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 ERC-1155 token balance held by a wallet address for a specific token ID on a given EVM chain","exampleAgentPrompt":"Check the ERC-1155 balance for wallet 0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf on the contract 0x76BE3b62873462d2142405439777e971754E8E77 for token ID 10373 on Ethereum.","exampleUseCases":[{"title":"NFT game item ownership check","prompt":"How many of item token ID 42 does wallet 0xABC123...DEF on the Polygon contract 0x111...999 currently hold? I need to verify if they have enough to enter the tournament."},{"title":"ERC-1155 airdrop eligibility verification","prompt":"Can you check if wallet 0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf holds any of ERC-1155 token ID 5 from contract 0x76BE3b62873462d2142405439777e971754E8E77 on Base? I need to see if they qualify for the airdrop."},{"title":"Multi-edition NFT balance audit","prompt":"Look up the balance of token ID 10373 from the Parallel Alpha NFT contract 0x76BE3b62873462d2142405439777e971754E8E77 on Ethereum for the wallet 0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf — and grab the metadata URI too."}],"resultDescription":"Returns a JSON object with the wallet address, network, contract address, token ID, amount (balance as a number), and the token's metadata URI. A balance of 0 means the wallet does not hold that token.","failureModes":["Invalid wallet address format returns an error or null result","Invalid or undeployed contract address yields a zero balance or error","Unsupported network name returns a validation error","Missing required fields (address, contract, token_id) returns a 400-level error","Token ID not existing on the contract may return amount 0","Network congestion or RPC issues may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need to check the balance of a specific ERC-1155 token ID for a specific wallet on a supported EVM chain (Base, Ethereum, Arbitrum, Optimism, Polygon, BNB, Avalanche, Gnosis, Linea, Scroll, Sonic, Unichain). It is ideal for ERC-1155 multi-token standard contracts (gaming items, semi-fungible tokens, multi-edition NFTs) where each token ID can have fractional or multiple holdings per wallet — unlike ERC-721 which is always 0 or 1.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:45:38.851Z","isFirstParty":false,"canonicalSlug":"vextorium-erc-1155-balance-lookup-06c6ed77"}