{"uid":"cap_xNRvhW_iXNM28L4qg5vmA","slug":"onesource-live-wallet-balance-eth-erc20-f94e695e","name":"OneSource Live Wallet Balance (ETH + ERC20)","description":"Live wallet balance - native ETH plus up to 20 caller-supplied ERC20 tokens in one bounded RPC batch","url":"https://api.onesource.io/api/chain/live-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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"tokens":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}(,0x[a-fA-F0-9]{40}){0,19}$","maxLength":859},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"network":{"enum":["ethereum","sepolia","robinhood"],"type":"string","default":"ethereum"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"balance":{"type":"string"},"contract":{"type":"string"},"decimals":{"type":"integer"}}}},"address":{"type":"string"},"eth_balance":{"type":"string"}},"description":"Endpoint-specific response payload"},"meta":{"type":"object","required":["endpoint","request_id"],"properties":{"endpoint":{"type":"string"},"cost_usdc":{"type":"string"},"request_id":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"}}},"error":{"type":["object","null"],"properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}}}},"responseSchema":{"type":"json","example":{"data":{"tokens":[{"symbol":"USDT","balance":"0x499602d2","contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","decimals":6}],"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","eth_balance":"0xde0b6b3a7640000"},"meta":{"endpoint":"/api/chain/live-balance","cost_usdc":"0.001","request_id":"00000000abcdef01","payment_chain":"base","payment_token":"USDC"}}},"example":{"request":{"tokens":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48,0x6B175474E89094C44Da98b954EedeAC495271d0F","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","network":"ethereum"},"response":{"data":{"tokens":[{"symbol":"USDC","balance":"0x0000000000000000000000000000000000000000000000000000000001daf661","contract":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","decimals":6},{"symbol":"DAI","balance":"0x0000000000000000000000000000000000000000000000003f7348f736b499b0","contract":"0x6B175474E89094C44Da98b954EedeAC495271d0F","decimals":18}],"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","eth_balance":"0x4ef2d23eda616ea6"},"meta":{"endpoint":"/api/chain/live-balance","request_id":"d4ba7a71fb41ac18"}}},"exampleRequest":{"tokens":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48,0x6B175474E89094C44Da98b954EedeAC495271d0F","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","network":"ethereum"},"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZqLNIS8jgQs7xepVORwb7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 plus balances of any specified ERC20 tokens for a given Ethereum wallet address in a single API call.","exampleAgentPrompt":"What's the live balance of Ethereum wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on mainnet — give me both its ETH balance and its USDC and DAI token balances?","exampleUseCases":null,"resultDescription":"Returns the native ETH balance (via eth_getBalance) and the balances of any specified ERC20 token contracts (via balanceOf eth_call) for the given wallet address, all in a single response. Balances are live and reflect the current on-chain state on either Ethereum mainnet or Sepolia testnet.","failureModes":["Invalid Ethereum address format (must be 0x-prefixed 40 hex chars) returns validation error","Invalid or unrecognized token contract address returns zero or error for that token","Unsupported network value (not 'ethereum' or 'sepolia') returns 400 error","Network RPC node unavailable returns 503 or timeout","Wallet address is valid but has zero balances — returns 0 for all fields","Payment not made or x402 auth missing returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need both native ETH and multiple ERC20 token balances for a wallet in a single call, rather than making separate calls for each token. Prefer this over single-token balance endpoints when checking portfolio state, monitoring wallet activity, or verifying that a wallet holds sufficient funds across multiple asset types.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:52:27.746Z","isFirstParty":false}