{"uid":"cap_ZywUtrcfsd79BZDPor5ni","slug":"base-chain-eth-balance-c594055d","name":"Base Chain ETH Balance","description":"Native ETH balance for one Base network address, read live from a public Base RPC node (eth_getBalance) and returned with the snapshot block it was read at.","url":"https://market.561.group/v1/base-chain/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":"The Base network address to read."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["address","weiBalance","snapshotBlock"],"properties":{"address":{"type":"string"},"weiBalance":{"type":"string"},"snapshotBlock":{"type":"string"}}}}}}},"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_i1fCYjQXtuMemqlBfVXMU","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 the live native ETH balance (in wei) for a given Base network address, along with the snapshot block number at which it was read.","exampleAgentPrompt":"What's the current ETH balance on Base for wallet address 0x742d35Cc6634C0532925a3b8D4C9B7C1f3a9E2b4?","exampleUseCases":[{"title":"DeFi pre-trade balance check","prompt":"Before I swap tokens, check if wallet 0x742d35Cc6634C0532925a3b8D4C9B7C1f3a9E2b4 has enough native ETH on Base to cover gas fees."},{"title":"Portfolio balance dashboard","prompt":"Pull the live ETH balance on Base for address 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B so I can display it in my portfolio tracker."},{"title":"Alerting on wallet depletion","prompt":"Check the current Base ETH balance for 0x1dB3D37Ff9f6E6Fe7f8A2C9E4B5a0D1c8f3E2A1 — I want to know the exact wei amount and what block it was read at so I can set up a low-balance alert."}],"resultDescription":"Returns a JSON object containing the queried address, the native ETH balance expressed as a wei string, and the block number (snapshotBlock) at which the balance was read from the Base RPC node.","failureModes":["Invalid or malformed Ethereum address (not matching ^0x[0-9a-fA-F]{40}$) returns a validation error","RPC node unavailability may cause timeouts or 503 errors","Address with zero balance returns weiBalance of '0' (not an error)","Missing required 'address' query parameter returns a 400-level error","Payment not received (x402 protocol) results in 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need a real-time, live-read native ETH balance on the Base network for a specific address and also need the snapshot block for auditability or consistency checks. Prefer this over general Ethereum balance APIs when the target chain is specifically Base (L2). Ideal for agents that need to gate actions on sufficient ETH balance or monitor wallet health on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:34:30.500Z","isFirstParty":false,"canonicalSlug":"base-chain-eth-balance-c594055d"}