{"uid":"cap_h5r-T9E18Vo0fI8kLIgSZ","slug":"financial-data-x402-wallet-balance-lookup-d3db2b56","name":"Financial Data x402 – Wallet Balance Lookup","description":"Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.","url":"https://x402financialdata.com/wallet-balance/%7Baddress%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"as_of":"2026-07-31T03:43:30.000000","chain":"eth","address":"0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae","balance":1.28453901,"balance_wei":"1284539010000000000","native_symbol":"ETH"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mLxhR4B8dCY2dkyCKdXXD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current native token balance for a given on-chain wallet address, including balance in both decimal and wei units, chain, and timestamp.","exampleAgentPrompt":"What's the current ETH balance for wallet address 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae on Ethereum?","exampleUseCases":[{"title":"DeFi portfolio native balance check","prompt":"Can you look up the current ETH balance for the wallet 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae and tell me both the human-readable amount and the raw wei value?"},{"title":"On-chain due diligence for a counterparty","prompt":"Before we proceed with this transaction, check how much ETH is currently sitting in wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B on Ethereum."},{"title":"Automated treasury balance monitoring","prompt":"Fetch the current native token balance for our treasury wallet 0x71C7656EC7ab88b098defB751B7401B5f6d8976F so I can see if it's dropped below the threshold we set."}],"resultDescription":"Returns a JSON object with the wallet address, chain identifier, timestamp of the balance snapshot, native token balance as a decimal float, balance expressed in wei (smallest unit), and the native token symbol (e.g. ETH). Example: {as_of, chain, address, balance, balance_wei, native_symbol}.","failureModes":["Invalid or malformed wallet address returns an error or empty response","Unsupported chain identifier may return no data","Payment failure via x402 (insufficient USDC balance or failed micropayment) blocks the request","Rate limiting or network congestion may cause timeouts","Address with zero balance may return balance of 0 rather than an error"],"whenToPreferThis":"Choose this endpoint when you need a pay-per-call, no-subscription way to fetch the current native token balance (e.g. ETH) of any on-chain wallet address. It is ideal for agents that need sporadic or one-off balance checks without committing to an API key or monthly plan, and when micropayment via USDC on Base or Solana is acceptable. Prefer alternatives if you need ERC-20 token balances, historical balance data, or multi-chain batch lookups in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:48:44.053Z","isFirstParty":false}