{"uid":"cap_LM-qoyF88ryWvibwaExAU","slug":"axiom-works-live-wallet-balance-eth-pol-erc20-897bd43f","name":"Axiom Works Live Wallet Balance (ETH/POL + ERC20)","description":"Live wallet balance — native ETH/POL plus up to 20 caller-supplied ERC20 tokens in one RPC batch (balanceOf + decimals + symbol). No hardcoded majors (use /wallet $0.003 for USDC/USDT/DAI/WETH pack). Example: {address:\"0xd8dA…6045\", tokens:\"0xdAC1…1ec7,0xA0b8…eB48\", chain:\"ethereum\"}. $0.002. Related: Native + majors pack: /wallet $0.003; single ERC20: /chain/erc20-balance $0.001; native only: /chain/balance $0.001.","url":"https://api.axiomworks.co.uk/chain/live-balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","description":"EVM chain (default base)"},"tokens":{"type":"string","description":"Comma-separated ERC20 contracts (max 20)"},"wallet":{"type":"string","description":"Alias for address (owner wallet)"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address"},"network":{"type":"string","description":"Alias for chain (onesource-compatible)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mzETfT_RWz45T2xwos_-Q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches live native token balance (ETH or POL) plus balances, decimals, and symbols for up to 20 caller-supplied ERC20 tokens in a single RPC batch call.","exampleAgentPrompt":"What's the live ETH balance and ERC20 token balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum, checking token contracts 0xdAC17F958D2ee523a2206206994597C13D831ec7 and 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?","exampleUseCases":[{"title":"DeFi portfolio snapshot for custom tokens","prompt":"Can you pull the live balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Arbitrum, including ERC20 contracts 0x912CE59144191C1204E64559FE8253a0e49E6548 and 0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC2?"},{"title":"Verify token receipt after on-chain transfer","prompt":"Check if wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aec9A on Base has received any of token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 yet — show me the live balance right now."},{"title":"Multi-token balance check on Polygon","prompt":"What are the current native POL and ERC20 balances on Polygon for address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, checking contracts 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 and 0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063?"}],"resultDescription":"Returns the native token balance (ETH or POL) in human-readable units alongside an array of ERC20 token objects, each containing the contract address, token symbol, decimals, and formatted balance — all retrieved in a single batched RPC call for the specified wallet and chain.","failureModes":["Invalid wallet address format returns a 400 validation error","More than 20 ERC20 contract addresses supplied causes a request rejection","Invalid or non-existent ERC20 contract address may return zero balance or an error","Unsupported chain name returns an enum validation error","Network congestion or RPC node issues may cause timeouts","Payment not provided or insufficient causes a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need native token balance plus balances for specific, custom, or lesser-known ERC20 tokens (not the standard USDC/USDT/DAI/WETH pack) for a single wallet in one batched call. It is cheaper than calling the native + majors pack (/wallet) if you only need a subset of tokens, and more efficient than making separate calls per token. Prefer the sibling /wallet endpoint if you specifically want the major stablecoin and WETH pack, or /chain/erc20-balance for a single ERC20 lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T18:40:02.942Z","isFirstParty":false,"canonicalSlug":"axiom-works-live-wallet-balance-eth-pol-erc20-897bd43f"}