{"uid":"cap_Un8auXmo94TgF4uTYlURE","slug":"datakoot-erc-20-token-balance-lookup-base-dd2e895d","name":"Datakoot ERC-20 Token Balance Lookup (Base)","description":"48 live public-data tools (security, packages, SEC filings, economy, FX, weather, domains, Federal Register, Base) for AI agents. $0.002 USDC per call on Base via x402, charged only on success. The same tools are free for 100 calls/day via MCP at <server>.datakoot.com/mcp.","url":"https://x402.datakoot.com/api/token_balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","description":"ERC-20 contract address on Base: 0x followed by 40 hex characters."},"address":{"type":"string","description":"Wallet address whose balance to read: 0x followed by 40 hex characters."}}},"responseSchema":{"type":"json","example":{"token":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","holder":"0x21217f943Fe780A3E95eBe3dfC95bEF2203cF3bB","symbol":"USDC","balance":"4.998","network":"base-mainnet","decimals":6,"balance_raw":"4998000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_yLnwalB2QjKaS1Hn_DVNZ","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 of a wallet address on the Base blockchain, including symbol, decimals, and raw balance.","exampleAgentPrompt":"What's the USDC balance (contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913) for the wallet 0x21217f943Fe780A3E95eBe3dfC95bEF2203cF3bB on Base?","exampleUseCases":[{"title":"Verify payout wallet before transfer","prompt":"Before I send funds, check how much USDC (0x833589fcd6edb6e08f4c7c32d4f71b54bda02913) is already sitting in wallet 0x21217f943Fe780A3E95eBe3dfC95bEF2203cF3bB on Base mainnet."},{"title":"Monitor airdrop recipient holdings","prompt":"I need to know if wallet 0xAbCd1234...5678 already received the airdrop — can you check its balance of our token at 0x1234567890abcdef1234567890abcdef12345678 on Base?"},{"title":"DeFi portfolio balance check","prompt":"How many tokens does wallet 0xDeadBeef...1111 hold for the token contract 0xABCDEF0123456789ABCDEF0123456789ABCDEF01 on Base — give me the human-readable balance and the raw amount."}],"resultDescription":"Returns a JSON object with the token contract address, holder wallet address, token symbol, human-readable balance (decimal string), raw balance (integer string), number of decimals, and the network name (base-mainnet).","failureModes":["Invalid ERC-20 contract address format (not 0x + 40 hex chars) — returns error","Invalid wallet address format — returns error","Contract address is not a valid ERC-20 token on Base — may return zero balance or error","Wallet has no holdings of the specified token — returns balance of 0","Network congestion or RPC timeout — request may fail or be slow","Payment not processed (USDC not deducted) — response not returned on failure"],"whenToPreferThis":"Use this endpoint when you need a reliable, pay-per-success ERC-20 token balance read on Base mainnet without managing your own RPC infrastructure. Prefer it over raw RPC calls when you want a clean JSON response with symbol, decimals, and human-readable balance already resolved. It is particularly useful for AI agents that need to verify wallet holdings, check airdrop status, or enrich payment workflows — and the x402 micropayment model means you only pay on successful data delivery.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:46:54.990Z","isFirstParty":false,"canonicalSlug":"datakoot-erc-20-token-balance-lookup-base-dd2e895d"}