{"uid":"cap_kaVcF9Eb1lyHyzFO9Eb5D","slug":"token-balance-erc-20-on-base-2e2a11d7","name":"Token Balance (ERC-20 on Base)","description":"🆕 An ERC-20 balance on Base, in raw units and in decimals, with the token's symbol and decimals resolved in the same call. Zero is flagged explicitly, since it is the commonest answer and the one most easily confused with a failed read. An address that doesn't implement balanceOf answers found:false and says so.","url":"https://402.com.tr/api/x402/token-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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["token","wallet"],"properties":{"token":{"type":"string","description":"Token contract"},"wallet":{"type":"string","description":"Wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_lZDzWpSEmvVMOetxtAzav","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":"Returns the ERC-20 token balance for a wallet address on Base, with raw units, decimal-adjusted amount, token symbol, and decimals, flagging zero balances and non-ERC-20 contracts explicitly.","exampleAgentPrompt":"What's the USDC balance for wallet 0xAbC...123 on Base? Give me both the raw amount and the human-readable decimal value, and let me know if it's zero or if the contract doesn't support balanceOf.","exampleUseCases":[{"title":"Pre-transfer balance check","prompt":"Before I send tokens, can you check how much LINK the wallet 0xDef...456 actually holds on Base — give me the balance in both raw units and the real decimal amount?"},{"title":"Airdrop eligibility verification","prompt":"I need to verify whether wallet 0x789...abc holds any of the token at contract 0x111...222 on Base — is the balance zero or do they actually have some?"},{"title":"Portfolio snapshot for a single token","prompt":"Pull the current balance of the DAI token (contract 0x50c...bcd) for my Base wallet 0xAaa...bbb, including the token symbol, decimals, and the human-readable amount."}],"resultDescription":"Returns the wallet's ERC-20 token balance in raw units (as returned by the contract) and in decimal-adjusted form, along with the token's symbol and decimals. Explicitly flags whether the balance is zero. If the contract address does not implement balanceOf (i.e., is not a valid ERC-20), returns found:false with an explanatory message.","failureModes":["Invalid or non-checksummed wallet address returns an error","Contract address that does not implement balanceOf returns found:false","Network or RPC timeout results in a failed read","Malformed query parameters (missing token or wallet) return a validation error","Token contract on a chain other than Base will not resolve correctly"],"whenToPreferThis":"Choose this endpoint when you need a single ERC-20 token balance on Base resolved in one call with both raw and decimal-adjusted values, the token symbol, and explicit zero/not-found signaling — avoiding the need for separate multicall or metadata lookups. Prefer it over general portfolio endpoints when you only need one specific token rather than a full multi-token sweep.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:46:33.967Z","isFirstParty":false}