{"uid":"cap_u6TPPWFaQzlN2iV12UrQL","slug":"wallet-balance-c79383d0","name":"Wallet Balance","description":"Wallet balances, tokens, transactions and prices on Base, Ethereum and Solana. Other Tollkit tools are described at: https://extract.tollkit.dev/openapi.json, https://attest.tollkit.dev/openapi.json, https://web.tollkit.dev/openapi.json, https://data.tollkit.dev/openapi.json.","url":"https://chain.tollkit.dev/chain/balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["base","ethereum","solana"],"type":"string","default":"base","description":"Which chain to read: \"base\" (default), \"ethereum\" or \"solana\"."},"tokens":{"type":"array","items":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$"},"maxItems":20,"description":"Extra ERC-20 contracts (or SPL mints on Solana) to include."},"address":{"type":"string","pattern":"^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$","description":"Wallet (or contract) address to check."}}},"responseSchema":{"type":"json","example":{"chain":"base","native":{"symbol":"ETH","balance":"0","balance_wei":"0"},"tokens":[{"name":"USD Coin","symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","balance":"2.222","decimals":6,"balance_raw":"2222000"}],"address":"0xBbfCE2D320dE6aB328Ba93A771c531ebFC9cE704","checked_at":"2026-10-04T07:45:36.553Z","is_contract":false,"block_number":52155294,"explorer_url":"https://basescan.org/address/0xBbfCE2D320dE6aB328Ba93A771c531ebFC9cE704"}},"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_8cc4ACGLo_biql5CY8csn","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":"Fetches native and ERC-20/SPL token balances for a given wallet or contract address on Base, Ethereum, or Solana, paid per-call via x402 in USDC.","exampleAgentPrompt":"What's the ETH balance and all ERC-20 token holdings for the wallet 0xAbCd1234...5678 on Ethereum?","exampleUseCases":[{"title":"DeFi portfolio snapshot","prompt":"Give me a full breakdown of native and token balances for 0xAbCd1234567890abcdef1234567890abcdef1234 on Base, including these ERC-20s: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and 0x6B175474E89094C44Da98b954EedeAC495271d0F."},{"title":"Solana airdrop eligibility check","prompt":"Check the SOL balance and SPL token holdings for the Solana wallet 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU."},{"title":"Smart contract treasury audit","prompt":"Look up the ETH and ERC-20 token balances for the contract address 0xDEF1...0099 on Ethereum so I can see what's in the treasury."}],"resultDescription":"Returns the native token balance (ETH, SOL, etc.) and balances for any requested ERC-20 or SPL tokens held by the specified address on the chosen chain, typically as a structured JSON object with token symbols, contract addresses, and formatted amounts.","failureModes":["Invalid address format — returns validation error if address doesn't match expected hex or base58 pattern","Unsupported chain — error if chain value is not 'base', 'ethereum', or 'solana'","Too many tokens — error if more than 20 token contracts are provided","Payment failure — x402 payment not accepted or insufficient USDC balance","Address not found or empty — returns zero balances or empty response for fresh/unused addresses","RPC timeout — underlying node may time out for heavily used contracts"],"whenToPreferThis":"Choose this endpoint when you need to check wallet or contract balances on Base, Ethereum, or Solana without setting up an account or API key — payment is handled inline via x402 USDC micropayments. It's ideal for ad-hoc, pay-as-you-go balance lookups inside autonomous agents or workflows where managing API credentials is impractical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:36:58.776Z","isFirstParty":false,"canonicalSlug":"wallet-balance-c79383d0"}