{"uid":"cap_lviDSzBzcJmicU-R-9MVt","slug":"base-erc-20-token-balance-lookup-8f873ce0","name":"Base ERC-20 Token Balance Lookup","description":"Call when an agent needs an ERC-20 balance_raw and human balance for token and owner on Base. Example token is Circle USDC. decimals() scales the human balance. Distinct from base-balance (native ETH). Read-only. No spend. Send JSON {\"token\":\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\"owner\":\"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\"}. Exact $0.003 USDC on Base. Try unpaid POST /v1/sandbox/base-erc20-balance first.","url":"https://agentshelf.syntexa.ch/v1/base-erc20-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"owner":{"type":"string","examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"description":"Wallet whose token balance is read. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045. EIP-55 or all one case. Returns balance_raw and a human balance from decimals()."},"token":{"type":"string","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"description":"ERC-20 contract on Base mainnet. Example: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (Circle USDC). EIP-55 or all one case. Paired with owner. Distinct from base-balance, which reads native ETH."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.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_hwghinpNJUjtw8geBOVvP","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 raw and human-readable ERC-20 token balance for a given token contract and owner wallet address on Base mainnet.","exampleAgentPrompt":"What's the USDC balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — give me both the raw amount and the human-readable number?","exampleUseCases":[{"title":"Portfolio USDC balance check","prompt":"Can you check how much USDC the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 currently holds on Base? I need the actual dollar-formatted amount."},{"title":"Pre-payment eligibility verification","prompt":"Before we proceed, verify that wallet 0xAbCd1234...5678 has at least 50 USDC on Base — look up its ERC-20 balance for token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Multi-wallet token audit","prompt":"Pull the USDC balance on Base for this wallet address 0x1234...abcd using token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, and show me both the raw wei-level value and the human-readable amount."}],"resultDescription":"Returns a JSON object containing balance_raw (the integer token balance in the token's smallest unit) and a human-readable balance derived by dividing balance_raw by 10^decimals(), reflecting the actual token amount the owner holds on Base mainnet.","failureModes":["Invalid or malformed token contract address returns an error","Invalid or malformed owner wallet address returns an error","Token contract address that is not an ERC-20 on Base mainnet may fail or return unexpected results","Network or RPC connectivity issues with Base mainnet may cause timeout or error","Unpaid requests to the paid endpoint return 402 Payment Required — use sandbox endpoint first"],"whenToPreferThis":"Use this endpoint when you need to check an ERC-20 token balance (such as USDC) on Base mainnet specifically, and need both the raw on-chain integer value and the decimal-scaled human-readable amount. Distinct from native ETH balance lookups. Prefer this over generic blockchain RPCs when you want a simple pay-per-call API without managing RPC node infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:38:15.093Z","isFirstParty":false,"canonicalSlug":"base-erc-20-token-balance-lookup-8f873ce0"}