{"uid":"cap_0CQzj_EhBTEW2XcIHCu2L","slug":"api-x402node-dev-6187ed49","name":"Ethereum Mainnet ETH Balance Lookup","description":"Ethereum mainnet native ETH balance for an address via LlamaRPC (no API key). Returns wei, eth, and optional USD value. Use ?address=0x... and with_usd=true. Built for AI agents doing portfolio reporting, fraud screening, and wallet onboarding. Accepts payment on Base or Solana — either network works.","url":"https://api.x402node.dev/chain/eth-balance","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","properties":{"address":{"type":"string","description":"EVM/chain address (optional)"},"with_usd":{"type":"string","description":"With_usd (optional)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","with_usd":true},"response":{"eth":5.69070571,"usd":9832.7428,"wei":"5690705707505023098","_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","eth_usd_rate":1727.86}},"exampleRequest":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","with_usd":true},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PEKJJQnorFE9MTBkY1vjC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the native ETH balance of an Ethereum address in wei, ETH, and optionally USD value via LlamaRPC","exampleAgentPrompt":"What's the current ETH balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — show me the amount in both ETH and USD?","exampleUseCases":null,"resultDescription":"A JSON object containing the queried Ethereum address, its balance in wei (raw), its balance in ETH (human-readable), and optionally its current USD equivalent value based on live pricing.","failureModes":["Invalid or malformed Ethereum address returns an error","LlamaRPC upstream outage causes timeout or 5xx","USD price feed unavailable when with_usd=true requested","Non-checksum address format may be rejected","Rate limiting or payment failure at x402 layer"],"whenToPreferThis":"Use this endpoint when you need on-chain native ETH balance for a specific Ethereum mainnet address without setting up your own RPC node or API key. Ideal for AI agents doing portfolio reporting, wallet onboarding checks, or fraud screening where a quick wei/ETH/USD balance lookup is needed. Prefer over manual RPC calls for convenience and built-in USD conversion.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:43.775Z","isFirstParty":false}