{"uid":"cap_mQ5AiQj_JwrwCPLfj47km","slug":"money-reactor-erc-20-balance-lookup-base-network-bcd23007","name":"Money Reactor ERC-20 Balance Lookup (Base Network)","description":"60+ agent-native micro APIs paid per call in USDC on Base via x402: fresh market data every call (market cap, top movers, funding rates, orderbook, RSI trading checklist, volatility, cycle position), funded bounty radar, honeypot trust scoring, token safety verdicts, AI chat (Llama 3.1), web reader, ERC-20 balances. No accounts, no API keys — instant on-chain settlement.","url":"https://mr-river7.makar52nn2016.workers.dev/api/erc20-balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"queryParams":{"type":"object","properties":{"address":{"type":"string","example":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","description":"Wallet address 0x... (alias: wallet)"},"contract":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Token contract address 0x... (alias: token)"}}}}},"output":{"type":"object","properties":{"example":{"symbol":"USDC","address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","balance":42.5,"network":"base","contract":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","decimals":6,"balanceRaw":"42500000"}}}}},"responseSchema":{"type":"json","example":{"symbol":"USDC","address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","balance":42.5,"network":"base","contract":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","decimals":6,"balanceRaw":"42500000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qrWOjPLOwcA8vSGNwb_9s","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ERC-20 token balance of a wallet address on the Base network, including human-readable and raw balance values.","exampleAgentPrompt":"What's the USDC balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — use the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":[{"title":"DeFi agent pre-trade balance check","prompt":"Before executing a swap, check how much USDC wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 currently holds on Base using contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I need to make sure there's enough to cover the trade."},{"title":"Portfolio tracker token snapshot","prompt":"Tell me the token balance for wallet 0xABC123...def on Base for the token at contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, including the raw balance and number of decimals."},{"title":"Payment verification for on-chain settlement","prompt":"Has wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 received any USDC yet? Check its balance on Base for contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 so I can confirm the payment came through."}],"resultDescription":"Returns a JSON object with the token symbol, normalized human-readable balance (e.g. 42.5), raw on-chain balance string (e.g. '42500000'), number of decimals, the network ('base'), the wallet address, and the token contract address.","failureModes":["Invalid wallet or contract address format returns an error response","Contract address is not a valid ERC-20 token on Base — may return zero or error","Wallet has zero balance — returns balance: 0, not an error","Network congestion or RPC issues may cause delayed or failed lookups","x402 payment failure (insufficient USDC for the $0.02 call fee) blocks the request"],"whenToPreferThis":"Use this endpoint when you need a fast, no-account, pay-per-call ERC-20 balance check on the Base network without setting up API keys or subscriptions. Ideal for AI agents that need on-demand on-chain data as part of a DeFi workflow, payment verification, or portfolio check. Prefer this over free RPC calls when you want a managed, structured JSON response with human-readable balance included.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-18T00:41:42.150Z","isFirstParty":false,"canonicalSlug":"money-reactor-erc-20-balance-lookup-base-network-bcd23007"}