{"uid":"cap_Ih0tNTP2enmRBcHa640g0","slug":"live-evm-wallet-snapshot-70b0b344","name":"Live EVM Wallet Snapshot","description":"Read one wallet's native balance, nonce, account type, and up to five ERC-20 balances from Base, Ethereum, or Arbitrum in one live request.","url":"https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/wallet_snapshot","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":{"block":{"type":"string","description":"Block tag or height; defaults to latest."},"chain":{"type":"string","description":"base, ethereum, or arbitrum; defaults to base."},"tokens":{"type":"string","description":"One to five comma-separated ERC-20 contract addresses. Defaults to the network's official USDC and WETH contracts."},"address":{"type":"string","description":"EVM wallet or contract address."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","network","account_type","nonce","native_balance","token_balances"],"properties":{"nonce":{"type":"string"},"network":{"type":"string"},"success":{"type":"boolean"},"account_type":{"type":"string"},"native_balance":{"type":"object","required":["asset","balance_formatted"],"properties":{"asset":{"type":"string"},"balance_formatted":{"type":"string"}},"additionalProperties":true},"token_balances":{"type":"array","items":{"type":"object","required":["symbol","balance_formatted"],"properties":{"symbol":{"type":"string"},"balance_formatted":{"type":"string"}},"additionalProperties":true}}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"nonce":"0","network":"base","success":true,"account_type":"eoa","native_balance":{"asset":"ETH","balance_formatted":"0.0"},"token_balances":[{"symbol":"USDC","balance_formatted":"0.0"},{"symbol":"WETH","balance_formatted":"0.0"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wyNKg2RgvfMAHmZPr4n2I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns native balance, nonce, account type, and up to five ERC-20 token balances for a given EVM wallet address on Base, Ethereum, or Arbitrum in a single live request.","exampleAgentPrompt":"What's the current ETH balance, nonce, account type, and USDC and WETH token balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet?","exampleUseCases":[{"title":"DeFi portfolio balance audit","prompt":"Pull a live snapshot for wallet 0xAbCd1234...5678 on Base — I need the native ETH balance, the nonce, whether it's a contract or EOA, and the USDC and WETH balances all in one shot."},{"title":"Pre-payment wallet verification","prompt":"Before I send funds, can you check the current ETH balance and nonce for 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on Arbitrum so I know it's an active account?"},{"title":"Multi-token treasury check","prompt":"Snapshot the token balances for our treasury wallet 0xBEEF...CAFE on Ethereum — I want native ETH plus the balances for these five ERC-20 contracts: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48, 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2, 0x6B175474E89094C44Da98b954EedeAC495271d0F, 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984, 0x514910771AF9Ca656af840dff83E8264EcF986CA."}],"resultDescription":"A JSON object containing: success status, network name, account type (EOA or contract), nonce as a string, native balance with asset symbol and formatted amount, and an array of up to five ERC-20 token balances each with symbol and formatted amount.","failureModes":["Invalid or malformed EVM address returns an error response","Unsupported chain value returns an error (only base, ethereum, arbitrum accepted)","More than five ERC-20 contract addresses provided may be rejected or truncated","Invalid block tag or height returns an error or empty result","Network RPC unavailability may cause timeouts or failed reads","Invalid ERC-20 contract addresses in tokens param may return zero balances or errors"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, multi-field wallet snapshot in a single API call — combining native balance, nonce, account type, and multiple ERC-20 token balances. It is more efficient than chaining separate balance and nonce lookups. Prefer this over the sibling 'Live EVM Native Balance' endpoint when you also need token balances or account metadata. Ideal for DeFi portfolio audits, pre-transaction checks, treasury monitoring, or wallet onboarding flows on Base, Ethereum, or Arbitrum.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:48:34.217Z","isFirstParty":false}