{"uid":"cap_zBZoRdK50oPfjwe54wfHy","slug":"mach-gallery-erc-20-balance-on-base-8fb56500","name":"Mach Gallery ERC-20 Balance on Base","description":"Fast, low-cost Base data for autonomous agents. No API keys, no subscriptions; pay per call with USDC over x402.","url":"https://api.mach.gallery/api/base/erc20-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 or token contract address on Base mainnet."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet or account address on Base mainnet."}}},"responseSchema":{"type":"json","example":{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","address":"0x0000000000000000000000000000000000000001","network":"eip155:8453","balance_atomic":"0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-eISAwNkXkf1C-P-de2OB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","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 given wallet address on the Base (EIP-155:8453) network","exampleAgentPrompt":"What's the USDC balance (token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base?","exampleUseCases":[{"title":"DeFi eligibility check before swap","prompt":"Before executing a swap, check whether wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds at least any USDC (token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) on Base."},{"title":"Portfolio balance snapshot","prompt":"Fetch the current cbETH (token 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22) balance for my wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B on Base so I can see my holdings."},{"title":"Airdrop eligibility verification","prompt":"Check if address 0x1234567890abcdef1234567890abcdef12345678 has any tokens of contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base — I need to verify eligibility before sending an airdrop."}],"resultDescription":"A JSON object containing the queried token address, wallet address, the network identifier (eip155:8453 for Base), and the token balance expressed in atomic (smallest) units as a string integer.","failureModes":["Invalid EVM address format (not a 20-byte hex) returns a validation error","Token contract address does not exist on Base — may return zero balance or an error","Wallet address with no interaction with the token returns balance_atomic of '0'","Payment failure via x402 if USDC allowance is insufficient","Network downtime or Base RPC issues may cause delayed or failed responses"],"whenToPreferThis":"Choose this endpoint when you need a fast, on-demand ERC-20 token balance check on the Base L2 network without setting up an API key or subscription. It is ideal for autonomous agents that need to pay per query in USDC via x402, making it cost-effective for infrequent or programmatic lookups. Prefer it over full node RPC calls when you want a simple HTTP POST interface with a clean JSON response, and over general blockchain explorers when you need machine-readable atomic balances rather than human-formatted displays.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T04:37:25.079Z","isFirstParty":false,"canonicalSlug":"mach-gallery-erc-20-balance-on-base-8fb56500"}