{"uid":"cap_QczO8pn3kWQQAGD5BsdAB","slug":"vextorium-evm-token-balance-50537bfe","name":"Vextorium EVM Token Balance","description":"Balance of one ERC-20 token in a wallet with symbol and decimals. Works on Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic and Unichain.","url":"https://api.vextorium.com/v1/evm-token-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["address","token"],"properties":{"token":{"type":"string"},"address":{"type":"string"},"network":{"enum":["base","ethereum","arbitrum","optimism","polygon","bnb","avalanche","gnosis","line","scroll","sonic","unichain"],"type":"string","description":"Chain (default base)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"name":{"type":["string","null"]},"token":{"type":["string","null"]},"symbol":{"type":["string","null"]},"wallet":{"type":["string","null"]},"balance":{"type":["number","null"]},"network":{"type":["string","null"]},"decimals":{"type":["number","null"]},"gross_balance":{"type":["string","null"]}}}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","wallet":"0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf","balance":1.541325,"network":"base","decimals":6,"gross_balance":"1541325"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_sq31_GxFqA6glau14a0T3","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 the token balance of a wallet address for an ERC-20 token on a specified EVM-compatible chain","exampleAgentPrompt":"Check how much USDC the wallet 0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf holds on Base — the USDC token contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.","exampleUseCases":[{"title":"DeFi portfolio wallet audit","prompt":"What's the USDC balance of wallet 0xb9f06D2734B7E9D7b21B64C4D8b95bd774b71aCf on Base? Use token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Pre-trade liquidity check","prompt":"Before I submit this swap, check if wallet 0xABC123...DEF has at least 500 WETH on Arbitrum — the WETH contract is 0x82aF49447D8a07e3bd95BD0d56f35241523fBab1."},{"title":"Multi-chain token holdings lookup","prompt":"Tell me the USDT balance on Polygon for wallet address 0x1234...5678 using token contract 0xc2132D05D31c914a87C6611C10748AEb04B58e8F."}],"resultDescription":"Returns a JSON object with the token name, symbol, contract address, wallet address, human-readable balance (float), raw gross balance (string, without decimals applied), number of decimals, and the network queried.","failureModes":["Invalid wallet address format returns an error or null balance","Invalid or non-ERC-20 token contract address returns null/empty result","Unsupported network name returns a validation error","Token not deployed on the specified network returns null balance","RPC node timeout or upstream chain unavailability causes a 5xx error","Malformed request body (missing required fields) returns a 400-level error"],"whenToPreferThis":"Use this endpoint when you need the current on-chain ERC-20 token balance for a specific wallet on a supported EVM chain (Base, Ethereum, Arbitrum, Optimism, Polygon, BNB, Avalanche, Gnosis, Linea, Scroll, Sonic, Unichain). Prefer it over Etherscan or Alchemy direct calls when you need a simple pay-per-use API without API key management. Ideal for AI agents needing balance checks as part of a DeFi workflow, pre-trade validation, or portfolio monitoring.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:51:51.424Z","isFirstParty":false,"canonicalSlug":"vextorium-evm-token-balance-50537bfe"}