{"uid":"cap_YojJbnb5V6U1drW0YJLL_","slug":"1gateway-base-onchain-balances-4c4fea8c","name":"1gateway Base Onchain Balances","description":"Use when an agent needs what a Base address holds in one call instead of one RPC call per token. Input: address; optional tokens (up to 20 ERC-20 addresses, comma-separated; default USDC, EURC, USDbC, WETH, cbBTC, cbETH, wstETH). Output: JSON block+time, ETH balance, 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/base/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":{"tokens":{"type":"string","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006"],"maxLength":900,"description":"Up to 20 comma-separated ERC-20 contract addresses on Base. Omit for the default set. A contract that is not an ERC-20 is listed with status not_an_erc20."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","examples":["0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1"],"description":"Wallet or contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). Bad input → 400 (not charged)"}},"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","tokenSet","tokens","nonZeroTokens","rpc","note"],"properties":{"eth":{"type":"object","properties":{"wei":{"type":"string"},"balance":{"type":"number"}}},"rpc":{"type":"object","properties":{"kind":{"type":"string"},"source":{"type":"string"}}},"note":{"type":"string"},"block":{"type":"object","properties":{"number":{"type":"integer"},"timestamp":{"type":"string"}}},"chain":{"type":"string"},"tokens":{"type":"array","items":{"type":"object","properties":{"raw":{"type":["string","null"]},"issuer":{"type":["string","null"]},"status":{"type":"string"},"symbol":{"type":["string","null"]},"address":{"type":"string"},"balance":{"type":["number","null"]},"decimals":{"type":["integer","null"]}}}},"address":{"type":"string"},"chainId":{"type":"integer"},"codeSize":{"type":"integer"},"tokenSet":{"type":"string"},"isContract":{"type":"boolean"},"nonZeroTokens":{"type":"integer"},"transactionCount":{"type":"integer"}}}}}}},"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_ZjtUQkxN4RaDeVL_mWWRP","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 ETH balance, ERC-20 token balances, nonce, contract status, and block metadata for any Base mainnet address in a single call","exampleAgentPrompt":"Check the ETH balance plus USDC and WETH holdings for 0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1 on Base mainnet and tell me if it's a contract or EOA.","exampleUseCases":[{"title":"DeFi portfolio snapshot for Base wallet","prompt":"Pull the full token breakdown for 0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1 on Base — I want ETH, USDC, WETH, cbBTC, and cbETH balances with decimals so I can see what this wallet holds right now."},{"title":"Verify user deposit before processing","prompt":"Before I release the order, check that 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 on Base has received at least some USDC — give me its current USDC balance and the block timestamp so I can confirm the timing."},{"title":"Classify address type and nonce check","prompt":"Is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base a smart contract or a regular wallet, and what's its current nonce and ETH balance?"}],"resultDescription":"Returns a JSON object with chain metadata (chain name, chainId, block number, block timestamp), ETH balance in wei and decimal, per-token entries with symbol, decimals, raw and decimal balance, address contract/EOA status with code size, transaction count (nonce), and the RPC source used. Tokens not found or not ERC-20 compliant are flagged with a status field.","failureModes":["400 returned for malformed address (not 0x + 40 hex or invalid EIP-55 checksum) — not charged","400 returned if more than 20 token addresses are supplied","Token listed as status: not_an_erc20 if the contract address is not a valid ERC-20","Network or RPC errors may return 5xx if Base node is unreachable","Invalid or unknown token contracts return null for symbol/decimals/balance with an error status"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive Base mainnet wallet snapshot — ETH plus up to 20 ERC-20 balances — in a single HTTP call instead of making separate RPC calls per token. It is ideal when you need block-timestamped, normalized decimal balances alongside contract detection and nonce in one response. It does not return token prices, so if you only need price data use a price feed instead. Best for agents auditing wallet state, verifying deposits, or building portfolio summaries on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:30:06.109Z","isFirstParty":false,"canonicalSlug":"1gateway-base-onchain-balances-4c4fea8c"}