{"uid":"cap_fsudIjyleAB5CykEAQ7VP","slug":"hermes-x402-toolkit-erc-20-token-balance-lookup-7b3cb270","name":"Hermes x402 Toolkit – ERC-20 Token Balance Lookup","description":"Pay-per-call data API for AI agents. No API key, no account, no signup — pay USDC on Base (eip155:8453) per request; free /api/meta lists all 22 endpoints. One call each: web page to LLM-ready text and link previews; China A-share quotes and limit-up pool; Chinese text and pinyin; Base/Ethereum on-chain reads (address, token, ERC-20 balances, tx, blocks, transfer history, gas price in USD); NFT records (collection, owner, and ipfs:// tokenURI resolved through public gateways); full-page screenshots; email verification without sending mail; ENS forward/reverse resolution; smart-contract due diligence (ABI, verified source, proxy); token security facts (owner, renounced ownership, paused, bytecode capability selectors); domain dossier (RDAP, DNS, TLS certificate, HTTP facts, hosting network).","url":"https://api.zlovev.com/api/chain/erc20-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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["token","address"],"properties":{"token":{"type":"string","description":"ERC-20 contract address on Base mainnet"},"address":{"type":"string","description":"Holder address to check"},"holders":{"type":"string","description":"Optional comma-separated list of up to 10 holder addresses (overrides address)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"block":51396188,"token":"0x8335…2913","symbol":"USDC","balances":[{"raw":"0","address":"0x5c67…d9EbB","balance":"0.0"}],"decimals":6}},"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_D2j6vSR6PnDOhfXrb9_4P","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(s) for one or more wallet addresses on Base mainnet, paid per-call via USDC over x402.","exampleAgentPrompt":"Check the USDC balance (contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913) for wallet address 0x5c67...d9EbB on Base mainnet.","exampleUseCases":[{"title":"Verify wallet holds enough USDC","prompt":"Can you check whether wallet 0xAbCd...1234 has at least 50 USDC on Base mainnet? The USDC contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Audit token distribution across wallets","prompt":"I need to check the USDC balances for these three addresses on Base all at once: 0xAAA...111, 0xBBB...222, and 0xCCC...333 — the token contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Monitor treasury wallet balance","prompt":"What's the current balance of our treasury wallet 0xDEF...789 for the token at contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base mainnet?"}],"resultDescription":"Returns a JSON object with ok status, the block number at which the query was made, the token contract address, token symbol, decimals, and an array of balance objects each containing the holder address, raw on-chain balance, and human-readable balance formatted to the token's decimals.","failureModes":["Invalid or malformed ERC-20 contract address returns an error response","Invalid or malformed holder address causes query failure","Token contract not deployed on Base mainnet returns error or zero balances","More than 10 addresses in the holders list may be rejected","Network congestion on Base may delay response","Payment failure or insufficient USDC for x402 fee results in 402 response and no data"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-account, no-API-key lookup of ERC-20 token balances on Base mainnet, especially for AI agent workflows that can pay micropayments via x402. Supports batch lookups of up to 10 addresses in a single call, making it efficient for multi-wallet checks. Prefer it over node-provider SDKs when you want a simple REST call with pay-per-use pricing and no subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:47:13.788Z","isFirstParty":false}