{"uid":"cap_NwyHSjfR-mso5pbu-rb79","slug":"base-address-snapshot-lookup-a2042fc9","name":"Base Address Snapshot Lookup","description":"Base address snapshot: ETH balance, tx count, contract or EOA","url":"https://agenttoll-pi.vercel.app/api/base/address/:address","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"},"pathParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ySHY8phrYECBwbfjcbfS2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ETH balance, transaction count, and account type (contract or EOA) for a given Base network address","exampleAgentPrompt":"Can you pull up the onchain snapshot for Base address 0x742d35Cc6634C0532925a3b8D4C9C0583c0fF9E — I want to know its ETH balance, how many transactions it's made, and whether it's a smart contract or a regular wallet.","exampleUseCases":[{"title":"Wallet due diligence before a transfer","prompt":"Before I send funds, can you check 0xAbCd1234567890aBcDeF1234567890abcDEF1234 on Base — what's its ETH balance, transaction count, and is it a contract or a regular wallet?"},{"title":"Classify airdrop recipient addresses","prompt":"I need to know if 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b is a smart contract or a normal EOA on Base, and what its current ETH balance is."},{"title":"Monitor a DeFi protocol's treasury","prompt":"What's the current ETH balance and transaction count for Base address 0xDeAd000000000000000042069420694206942069, and is it a contract account?"}],"resultDescription":"Returns a JSON object containing the ETH balance of the address, its total transaction count on Base, and its account type classification (contract vs. EOA — externally owned account), giving a concise onchain profile of the address.","failureModes":["Invalid address format (not a 0x-prefixed 40-hex-char string) returns a validation error","Address not found or never used on Base may return zero values for balance and tx count","RPC or node connectivity issues may cause 5xx errors","Payment failure (x402) if USDC balance is insufficient blocks the request","Rate limiting if too many requests are made in a short window"],"whenToPreferThis":"Use this endpoint when you need a quick, single-call summary of a Base network address — specifically when you want ETH balance, transaction count, and contract/EOA classification in one shot without querying a block explorer manually. Prefer this over general blockchain APIs when you're working specifically on the Base L2 and need low-latency, pay-per-call access without API key setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:35.807Z","isFirstParty":false}