{"uid":"cap_RxIoqE7kGwJ16CQzn8gNG","slug":"x402-web-extract-evm-wallet-balance-8dbd214f","name":"x402-web-Extract EVM Wallet Balance","description":"Pay-per-call API for AI agents on Base mainnet (USDC via CDP x402 facilitator). Three endpoints: /fetch returns clean markdown or JSON from any public URL, /price returns real-time USDC spot prices for EVM tokens, /balance returns native + USDC balances for any EVM wallet. Each call returns HTTP 402 with an exact payment requirement; agents pay automatically via x402. No API keys, no accounts.","url":"https://x402-web-extract.senpi-agent.workers.dev/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","chain"],"properties":{"chain":{"type":"string","description":"Chain id: base, ethereum, polygon, arbitrum, optimism."},"address":{"type":"string","description":"EVM wallet address."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"usdc":"0.00","chain":"base","native":"0.0000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_pq6uM609c95rYUJGgoJYm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns native token and USDC balances for any EVM wallet address on supported chains, paid per-call via x402 micropayments","exampleAgentPrompt":"What's the USDC and native ETH balance for wallet 0xAbC123...def on Base mainnet?","exampleUseCases":[{"title":"DeFi agent treasury check","prompt":"Before executing the swap, check how much USDC and ETH is currently in wallet 0xAbC123...def on Base — I need to know if there's enough to cover the trade."},{"title":"Multi-chain portfolio snapshot","prompt":"Look up the native token and USDC balances for 0xDead...Beef on Polygon so I can see how that chain is doing in my portfolio."},{"title":"Automated funding threshold monitor","prompt":"Check the USDC balance on Arbitrum for address 0x1234...5678 — I want to know if it's dropped below my threshold so I can top it up."}],"resultDescription":"Returns a JSON object with three fields: 'chain' (the chain ID queried), 'native' (balance of the chain's native token, e.g. ETH, MATIC), and 'usdc' (USDC balance), both as decimal strings with 4 decimal places. Example: {\"usdc\":\"0.00\",\"chain\":\"base\",\"native\":\"0.0000\"}","failureModes":["Invalid or malformed EVM address returns an error response","Unsupported chain ID returns an error or empty result","Payment not satisfied (HTTP 402 not resolved) blocks the call","Network or RPC timeout may result in a failed or stale response","Zero balances returned legitimately if wallet holds no funds"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, no-account, pay-per-call lookup of both native and USDC balances for any EVM address across Base, Ethereum, Polygon, Arbitrum, or Optimism. Ideal for AI agents that need on-chain balance checks as part of automated workflows without API key provisioning. Prefer over block explorer APIs or full node RPC calls when simplicity, micropayment billing, and multi-chain coverage in a single call are priorities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:39:44.154Z","isFirstParty":false,"canonicalSlug":"x402-web-extract-evm-wallet-balance-8dbd214f"}