{"uid":"cap_bFf0SR7PyjEZbUMnW7VI0","slug":"token-balance-lookup-erc-20-on-chain-3d3e76c3","name":"Token Balance Lookup (ERC-20, On-Chain)","description":"Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.","url":"https://x402-stock-indicators.vercel.app/token-balance/%7Baddress%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"note":"raw_balance is in the token's smallest unit -- this endpoint doesn't return the token's decimals, so divide by 10**decimals yourself for a human-readable amount (most ERC-20s use 18, but not all).","chain":"eth","address":"0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae","raw_balance":"125500000","token_contract":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OnM7eQlUeIzfHGg0vJuQF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the raw on-chain token balance for a given wallet address and ERC-20 token contract, paid per-call via x402 with USDC.","exampleAgentPrompt":"What's the on-chain token balance of wallet 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae for the USDC contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on Ethereum?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Can you check how many tokens the wallet 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae holds for the token contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 on Ethereum?"},{"title":"Verify airdrop eligibility on-chain","prompt":"Before we process this airdrop, check whether the wallet 0xABC123...def holds any balance of the token at contract 0xTokenContract...456 on Ethereum."},{"title":"Monitor whale wallet holdings","prompt":"Look up the raw on-chain balance of the token contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 held by wallet 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae — I want the smallest-unit balance so I can calculate it myself."}],"resultDescription":"Returns a JSON object containing the chain identifier (e.g. 'eth'), the queried wallet address, the token contract address, and the raw balance in the token's smallest unit (e.g. wei or base units for ERC-20s). Callers must divide by 10^decimals themselves since decimal metadata is not included in the response.","failureModes":["Invalid or malformed wallet address returns an error","Invalid or non-existent token contract address may return zero balance or an error","Unsupported chain identifiers may result in a lookup failure","Payment failure via x402 (insufficient USDC, wrong chain) will block the request","Network or RPC node outages may cause timeouts or stale data"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-subscription, pay-per-call on-chain ERC-20 token balance for a specific wallet and contract address, especially in agentic workflows where API key management is impractical. It is ideal for one-off or low-frequency balance checks billed in micro-USDC via x402. If you need decimal metadata or human-readable amounts directly, you may need to combine this with a token metadata endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:53:49.727Z","isFirstParty":false}