{"uid":"cap_Ts0kjbkBLEG8toVIcWsEo","slug":"1gateway-evm-wallet-balance-checker-2a36f509","name":"1gateway EVM Wallet Balance Checker","description":"Use when an agent needs an EVM wallet's holdings in one call. Input: address; chain (base default, ethereum, arbitrum, monad); optional tokens (up to 20 ERC-20s; default: main stablecoins, WETH, BTC wrappers). Output: JSON block+time, native balance (ETH; MON on Monad), per-token symbol, decimals, raw and decimal balance, nonce, isContract. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1","url":"https://1gateway.dev/v1/onchain/balances?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","monad"],"type":"string","description":"EVM chain (default base)"},"tokens":{"type":"string","maxLength":900,"description":"Up to 20 comma-separated ERC-20 contract addresses on the chosen chain. Omit for the default set. A…"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet or contract (0x + 40 hex; mixed case must be a valid EIP-55 checksum). Bad input → 400 (not …"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["chain","chainId","address","block","isContract","codeSize","transactionCount","eth","native","tokenSet"],"properties":{"eth":{"type":"object","properties":{"wei":{"type":"string"},"balance":{"type":"number"}},"additionalProperties":true},"block":{"type":"object","properties":{"number":{"type":"integer"},"timestamp":{"type":"string"}},"additionalProperties":true},"chain":{"type":"string"},"native":{"type":"object","properties":{"wei":{"type":"string"},"symbol":{"type":"string"},"balance":{"type":"number"}},"additionalProperties":true},"address":{"type":"string"},"chainId":{"type":"integer"},"codeSize":{"type":"integer"},"tokenSet":{"type":"string"},"isContract":{"type":"boolean"},"transactionCount":{"type":"integer"}},"additionalProperties":true}}}}},"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_f9hUIsrc4yGXk5UhtFczk","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 native and ERC-20 token balances for an EVM wallet address in a single call across Base, Ethereum, Arbitrum, or Monad","exampleAgentPrompt":"Can you pull all the token balances for 0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1 on Base — native ETH plus the main stablecoins and WETH?","exampleUseCases":[{"title":"Pre-transfer balance check","prompt":"Before I send funds, check whether 0xAbCd1234...5678 has enough USDC and ETH on Base to cover a transfer — show me the raw and decimal balances."},{"title":"DeFi portfolio snapshot","prompt":"Give me a full token holdings snapshot for 0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1 on Ethereum, including USDC, USDT, WETH, and WBTC balances and the current block number."},{"title":"Smart contract treasury audit","prompt":"I need to audit the on-chain holdings of the contract at 0xDeF9...4321 on Arbitrum — tell me if it's a contract, what its nonce is, and list all its ERC-20 balances."}],"resultDescription":"Returns a JSON object containing the queried chain name and chainId, block number and timestamp, whether the address is a contract, code size, transaction count (nonce), native balance in both wei and decimal (ETH or MON on Monad), and an array of token objects each with symbol, decimals, raw balance, decimal balance, issuer, and status fields. Also includes the RPC source metadata and any notes.","failureModes":["400 Bad Request if address is malformed or not a valid EIP-55 checksum (not charged)","400 if more than 20 token addresses are supplied","Token entry has status 'not_an_erc20' if a supplied contract address is not an ERC-20","Network or RPC timeout if the target chain is congested","Unsupported chain value returns 400"],"whenToPreferThis":"Use this endpoint when you need a complete, single-call snapshot of both native and ERC-20 token balances for an EVM address without price data. Ideal for pre-flight checks before transfers, portfolio audits, or treasury monitoring. Supports Base (default), Ethereum, Arbitrum, and Monad. Prefer over multi-call or block explorer scraping when you need raw+decimal balances, nonce, and contract detection in one response.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T12:15:00.071Z","isFirstParty":false,"canonicalSlug":"1gateway-evm-wallet-balance-checker-2a36f509"}