{"uid":"cap_xW_8geTFqErPmWq24GZi_","slug":"wallet-balance-native-eth-base-erc-20-512c2795","name":"Wallet Balance — Native ETH/Base + ERC-20","description":"Pay-per-call x402 APIs for AI agents: OpenAI-compatible LLM chat, perp funding and arbitrage spreads, crypto prices, gas, FX, Solana SPL mint audit, token price by contract, x402 delivery-receipt verification, web search, clean page extraction, batch tools and deterministic code-security scanning. USDC on Base or Solana, no signup, no API key, from $0.0001 a call.","url":"https://scanpay-edge.alextaghiashvili.workers.dev/api/v1/wallet-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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"tokens":{"type":"array","items":{"type":"string"}},"address":{"type":"string"},"network":{"enum":["base","ethereum"],"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"native":0.001,"tokens":[{"raw":1000000,"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}],"address":"0x1E04f5046500e5369E17AF993Dc60aC29D83efc9","network":"base","product":"scanpay.wallet_balance","chain_id":"eip155:8453","price_usd":0.003,"native_wei":1000000000000000}},"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_jHF0HF4lmzTDpGcrkJdTP","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 native ETH/Base balance and up to 20 ERC-20 token balances for a given wallet address on Base or Ethereum.","exampleAgentPrompt":"What's the native ETH balance and USDC balance (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet 0x1E04f5046500e5369E17AF993Dc60aC29D83efc9 on Base?","exampleUseCases":[{"title":"DeFi portfolio snapshot","prompt":"Can you pull the ETH balance plus USDC and WETH token balances for my wallet 0xAbC1234567890DeF on Base so I can see my current holdings?"},{"title":"Pre-payment balance check","prompt":"Before I send a transaction, check whether wallet 0x9F3d2C8a1B4e7F0c6D5E has enough ETH and USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) to cover the payment on Base mainnet."},{"title":"Monitoring airdrop receipt","prompt":"Has the airdropped token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 landed in wallet 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on Base yet? Show me the current balance."}],"resultDescription":"A JSON object containing the wallet address, network name, chain ID, native balance in ETH and wei, an array of ERC-20 token balances (each with raw balance and contract address), and the USD price of the call.","failureModes":["Invalid or malformed wallet address returns an error","Unsupported network or chain ID returns an error","ERC-20 contract address not found on specified chain returns null or zero balance","Rate limiting or payment failure (x402) returns 402 Payment Required","More than 20 token addresses supplied may be rejected or truncated"],"whenToPreferThis":"Use this endpoint when you need both native (ETH/Base) and multiple ERC-20 balances for a single wallet in one call, especially on Base or Ethereum mainnet, and want a pay-per-call model without managing an RPC node or API key. Prefer this over raw RPC calls when you want a clean JSON abstraction and are already operating within an x402 payment-enabled agent context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:47:10.867Z","isFirstParty":false,"canonicalSlug":"wallet-balance-native-eth-base-erc-20-512c2795"}