{"uid":"cap_O_KXfj46vJ-3p3DWGvc4P","slug":"proofsignal-erc-20-token-balance-base-mainnet-5b97a725","name":"ProofSignal ERC-20 Token Balance (Base Mainnet)","description":"Live Base ERC-20 token balance with token symbol, decimals, atomic amount, human-readable amount, and current block.","url":"https://enough-kate-provide-bennett.trycloudflare.com/base/erc20-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"],"type":"string"},"queryParams":{"type":"object","required":["token","address"],"properties":{"token":{"type":"string","description":"0x-prefixed ERC-20 token contract address on Base mainnet"},"address":{"type":"string","description":"0x-prefixed wallet or contract address whose token balance should be read"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ww5b6EipwyxqtKxdFhQqo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the live ERC-20 token balance for a wallet or contract address on Base mainnet, including token symbol, decimals, atomic amount, human-readable amount, and current block.","exampleAgentPrompt":"What's the current USDC balance of wallet 0xAbC123...def456 on Base mainnet? I need the human-readable amount, atomic amount, token decimals, and which block it was read from.","exampleUseCases":[{"title":"DeFi portfolio tracker balance check","prompt":"Check the USDC balance for wallet 0x1234567890abcdef1234567890abcdef12345678 on Base — I need the human-readable amount and the token symbol so I can display it in the portfolio dashboard."},{"title":"Automated payment eligibility verification","prompt":"Before triggering the payout, confirm that address 0xdeadbeef00000000000000000000000000000001 holds at least 100 DAI on Base — fetch its current token balance including the atomic amount and current block."},{"title":"Onchain activity monitoring alert","prompt":"Monitor wallet 0xaabbccddeeff00112233445566778899aabbccdd for its WETH balance on Base and alert me whenever the human-readable amount drops below 0.5 — start by fetching the current balance right now."}],"resultDescription":"Returns a JSON object containing the ERC-20 token symbol, number of decimals, raw atomic balance (BigInt string), human-readable balance (decimal string), and the current Base mainnet block number at which the balance was recorded.","failureModes":["Invalid or non-checksummed token contract address returns an error or zero balance","Invalid wallet address format causes a 400-level error","Token address is not a valid ERC-20 contract on Base mainnet, returning an error or empty response","Network congestion or RPC node issues may cause timeouts","Trycloudflare tunnel may be ephemeral and go offline, returning connection errors"],"whenToPreferThis":"Use this endpoint when you need a real-time, single-call lookup of an ERC-20 token balance on Base mainnet with full token metadata (symbol, decimals, atomic and human-readable amounts) and the current block context. Prefer it over generic blockchain explorers when you need structured programmatic output ready for agent pipelines. Choose it over Ethereum mainnet balance endpoints specifically for Base L2 balances.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:37:48.774Z","isFirstParty":false}