{"uid":"cap_YmpAobIVTMFW2vTKNkKuf","slug":"base-chain-wallet-balance-lookup-fb0afa7f","name":"Base Chain Wallet Balance Lookup","description":"Pay-per-call API for AI agents: turn any public web page or PDF into clean, LLM-ready Markdown. $0.002 per call in USDC on Base via x402. No API key, no signup.","url":"https://lin-desk-x402.lindesk.workers.dev/v1/base/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"EOA or contract address on Base mainnet"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"eth":{"type":"string"},"usdc":{"type":"string"},"as_of":{"type":"integer"},"address":{"type":"string"},"eth_wei":{"type":"string"},"usdc_raw":{"type":"string"},"disclaimer":{"type":"string"},"is_contract":{"type":"boolean"},"block_number":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"eth":"1","usdc":"0","as_of":1791100000,"chain":"base","cached":false,"address":"0x4200000000000000000000000000000000000006","eth_wei":"1000000000000000000","chain_id":8453,"usdc_raw":"0","disclaimer":"Read-only on-chain data; not financial advice.","elapsed_ms":45,"is_contract":true,"block_number":52120000,"usdc_contract":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}},"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_uDuy24d6-_Zlyed7-dr0I","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 the ETH and USDC balance of any Ethereum address on Base mainnet, including block number and contract detection.","exampleAgentPrompt":"Can you check how much ETH and USDC the wallet 0x4b8ad7ffc8cd960f696059041132339386c28831 holds right now on Base mainnet, and tell me if it's a contract or a regular wallet?","exampleUseCases":[{"title":"DeFi agent portfolio check","prompt":"Look up the current ETH and USDC balances for the address 0xAbCd1234...5678 on Base mainnet — I want to know if it's a contract and what block the data is from."},{"title":"Payment verification before transfer","prompt":"Before I send funds, can you check the USDC balance of 0x1234abcd...ef56 on Base so I know the recipient's current balance?"},{"title":"On-chain audit of agent wallet","prompt":"Pull the on-chain ETH and USDC balance for my agent's wallet 0xDEAD...BEEF on Base mainnet and tell me the block number the reading is from."}],"resultDescription":"A JSON object containing the wallet's ETH balance (human-readable and in wei), USDC balance (human-readable and raw), the block number and timestamp of the reading, whether the address is a contract, the chain ID (8453 for Base), and a disclaimer that the data is read-only and not financial advice.","failureModes":["Invalid address format (not matching 0x + 40 hex chars) returns a validation error","Address not found or zero-balance wallets return balances of 0 rather than an error","Network congestion on Base may cause increased latency","Payment failure via x402 prevents the request from being processed","RPC node downtime may cause lookup failures"],"whenToPreferThis":"Use this endpoint when you need a lightweight, pay-per-call on-chain balance check for any Base mainnet address without requiring API key registration. It is ideal for AI agents that need to verify wallet balances programmatically and pay micro-amounts per lookup via x402/USDC. Prefer it over full blockchain indexers when you only need current ETH and USDC balances for a single address and want minimal setup overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:45:43.127Z","isFirstParty":false,"canonicalSlug":"base-chain-wallet-balance-lookup-fb0afa7f"}