{"uid":"cap_vOTeIsQMhyR73P8Z_JmYY","slug":"ambolt-base-erc-20-token-balance-lookup-f48e5159","name":"Ambolt Base ERC-20 Token Balance Lookup","description":"Pay-per-call data tools for developers and AI agents: company registers, documents, tenders, rates and on-chain facts as MCP tools, x402 endpoints and Apify Actors.","url":"https://api.ambolt.dev/v1/base-erc20-balance?utm_source=zero.xyz","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":{"const":"http"},"method":{"enum":["GET","POST"]},"queryParams":{"type":"object","required":["address","token"],"properties":{"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 token contract address on Base."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address."}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"name":"USD Coin","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","readAt":"2026-10-02T21:35:40.251Z","symbol":"USDC","address":"0x4200000000000000000000000000000000000016","balance":"0","chainId":8453,"network":"base","decimals":6,"balanceRaw":"0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2WHrZ2vs2Rl6_HRbAlxAj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the ERC-20 token balance for a given wallet address on the Base blockchain network.","exampleAgentPrompt":"What's the USDC balance for wallet 0x4200000000000000000000000000000000000016 on Base? The USDC contract address is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.","exampleUseCases":[{"title":"DeFi pre-trade balance check","prompt":"Before I swap, check how much USDC the wallet 0xAbC1230000000000000000000000000000000001 currently holds on Base — the USDC contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Wallet portfolio snapshot","prompt":"I want to see the token balance for address 0xDef4560000000000000000000000000000000002 for the cbBTC token at contract 0xcbB7C0000b0d9E8E57c961d8E6A1e0e2a0bF5c0 on Base."},{"title":"Automated payment eligibility check","prompt":"Check if the wallet 0x1111111100000000000000000000000000000003 has any USDC balance on Base — contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — so I can decide whether to trigger a payout."}],"resultDescription":"Returns a JSON object containing the token name, symbol, decimals, the human-readable balance, the raw on-chain balance (in base units), the wallet address, the token contract address, the Base chain ID (8453), the network name, and a timestamp indicating when the balance was read.","failureModes":["Invalid wallet address format (not a valid 0x Ethereum address) returns an error","Invalid token contract address (not a deployed ERC-20 on Base) may return zero balance or error","Network/RPC outage on Base may cause timeout or stale data","Payment failure (insufficient USDC for x402 fee) blocks the request","Requesting a token address that is not an ERC-20 contract returns unexpected results"],"whenToPreferThis":"Choose this endpoint when you need a real-time, on-chain ERC-20 token balance for any wallet on the Base network specifically. It is ideal for DeFi automation, payment eligibility checks, portfolio monitoring, or any agentic workflow that must verify holdings before executing a transaction. Prefer this over generic blockchain RPCs when you want a structured, parsed response (human-readable balance plus decimals) without writing raw RPC calls.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:45:01.703Z","isFirstParty":false,"canonicalSlug":"ambolt-base-erc-20-token-balance-lookup-f48e5159"}