{"uid":"cap_edGWoLC_Ok6KYPoD_FkVG","slug":"quickbuild-base-wallet-balance-lookup-56bea749","name":"QuickBuild Base Wallet Balance Lookup","description":"Landing pages ($15), Google Sheets/Apps Script automation ($10), scrapers, scripts & Telegram bots (from $15), broken-link + sitemap audit reports ($10). See a working demo first, pay after.","url":"https://quickbuild.quynguyenbac.workers.dev/api/base/wallet?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":[],"properties":{"tokens":{"type":"string","description":"Optional comma-separated extra ERC-20 contract addresses on Base (max 10)."},"address":{"type":"string","description":"Base address (0x + 40 hex). Optional: defaults to 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 (vitalik.eth)."},"includeZero":{"type":"boolean","description":"Also list well-known tokens with zero balance (default false)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"eth":{"type":"object","properties":{"usd":{"type":["number","null"]},"wei":{"type":"string"},"balance":{"type":"string"}}},"nonce":{"type":"integer"},"tokens":{"type":"array","items":{"type":"object","properties":{"raw":{"type":"string"},"usd":{"type":["number","null"]},"symbol":{"type":["string","null"]},"address":{"type":"string"},"balance":{"type":["string","null"]},"decimals":{"type":["integer","null"]}}}},"address":{"type":"string"},"totalUsd":{"type":"number"},"isContract":{"type":"boolean"},"accountType":{"enum":["eoa","eoa-eip7702","contract"],"type":"string"},"blockNumber":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"eth":{"usd":0,"wei":"0","balance":"0"},"nonce":0,"tokens":[{"raw":"50000","usd":0.05,"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","balance":"0.05","decimals":6}],"address":"0x751a4c3841bE287544C371B4EE09Bd3366AeA7cf","chainId":8453,"totalUsd":0.05,"isContract":false,"accountType":"eoa","blockNumber":52868213}},"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_j4XI6CZgHJ29rJoTTA4nT","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":"Returns ETH balance, ERC-20 token balances, USD values, nonce, and account type for any address on the Base blockchain","exampleAgentPrompt":"What's the current ETH and token balance (including USD totals) for the Base address 0x751a4c3841bE287544C371B4EE09Bd3366AeA7cf? Also include any USDC and WETH holdings.","exampleUseCases":[{"title":"Portfolio snapshot for a Base wallet","prompt":"Can you pull the full token portfolio for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base, including ETH and all ERC-20 balances with their USD values?"},{"title":"Verify smart contract vs EOA account type","prompt":"Tell me whether the Base address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 is a smart contract or a regular wallet, and show its ETH balance."},{"title":"Check custom token balance on Base","prompt":"Look up the balance of my Base wallet 0x751a4c3841bE287544C371B4EE09Bd3366AeA7cf and also include the balance for this ERC-20 token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — show me the USD value too."}],"resultDescription":"A JSON object containing: the queried address, ETH balance in wei and formatted, ETH price in USD, an array of ERC-20 token objects (address, symbol, raw balance, formatted balance, decimals, USD value), total portfolio USD value, account nonce, account type (eoa, eoa-eip7702, or contract), and the block number at time of query.","failureModes":["Invalid or malformed address returns an error — address must be 0x followed by 40 hex characters","More than 10 custom ERC-20 contract addresses in `tokens` parameter causes rejection","Unknown or non-existent ERC-20 contract address may return null symbol/balance fields","RPC or network unavailability may cause timeout or 5xx error","Payment not included or insufficient USDC (< $0.002) results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a complete wallet snapshot on the Base network (L2), including both native ETH and multiple ERC-20 token balances with real-time USD pricing, in a single call. Prefer this over Ethereum mainnet balance APIs when the target address is on Base (chainId 8453). Ideal for portfolio dashboards, wallet monitoring, or verifying token holdings before executing a transaction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:30:06.001Z","isFirstParty":false,"canonicalSlug":"quickbuild-base-wallet-balance-lookup-56bea749"}