{"uid":"cap_HzV30g28WRpBUHl6m23XN","slug":"scanpay-token-balance-batch-a0313919","name":"ScanPay Token Balance Batch","description":"Pay-per-call x402 APIs for AI agents: OpenAI-compatible LLM chat, perp funding and arbitrage spreads, crypto prices, gas, FX, Solana SPL mint audit, token price by contract, x402 delivery-receipt verification, web search, clean page extraction, batch tools and deterministic code-security scanning. USDC on Base or Solana, no signup, no API key, from $0.0001 a call.","url":"https://scanpay-edge.alextaghiashvili.workers.dev/api/v1/token-balance-batch?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":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","required":["address","token"],"properties":{"token":{"type":"string"},"address":{"type":"string"},"network":{"enum":["base","ethereum"],"type":"string"}}}}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":1,"product":"scanpay.token_balance_batch","results":[{"ok":true,"token":"0x8335…","address":"0x0000…","balance":1,"network":"base","decimals":6,"balance_str":"1.000000"}],"price_usd":0.005}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aICECGO-WsnTLL22GVIs7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Batch-fetches ERC-20 token balances for up to 10 wallet/token pairs on Base or Ethereum networks in a single call.","exampleAgentPrompt":"Can you check the USDC balance (token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) for these three wallets on Ethereum: 0xabc...111, 0xdef...222, and 0x123...333?","exampleUseCases":[{"title":"DeFi portfolio balance snapshot","prompt":"Fetch the USDC and USDT balances for my five wallet addresses on Base all at once — wallet addresses are 0xAAA...1, 0xBBB...2, 0xCCC...3, 0xDDD...4, 0xEEE...5 and the token contracts are 0xUSDC and 0xUSDT on Base."},{"title":"Airdrop eligibility token check","prompt":"Before running our airdrop, check whether these 8 wallets already hold our ERC-20 token (contract 0xTKN...abc) on Ethereum — here are the wallet addresses: 0x1...0x8."},{"title":"Smart contract funding verification","prompt":"Verify that wallet 0xPAYER...xyz holds at least enough WETH (0xC02aa...token) on Ethereum to cover our transaction — can you pull the current token balance?"}],"resultDescription":"Returns a JSON object containing a results array of up to 10 items, each with the wallet address, token contract address, network, raw balance as a number, human-readable balance string (formatted with token decimals), token decimals, and a success flag. Also includes a count of results, the product identifier, and the USD price charged for the call.","failureModes":["Invalid or malformed wallet/token address returns an error entry with ok:false for that pair","Unsupported network (not Base or Ethereum) may return an error or empty result","More than 10 wallet/token pairs submitted may be rejected or truncated","RPC node unavailability may cause transient eth_call failures","Token contract that is not a standard ERC-20 may return unexpected results or fail balanceOf call","Rate limiting or payment failure may block the request entirely"],"whenToPreferThis":"Choose this endpoint when you need to query ERC-20 token balances for multiple wallet/token pairs on Base or Ethereum in a single batched call, avoiding multiple round-trips. It is ideal for portfolio snapshots, airdrop eligibility checks, funding verifications, or any workflow needing bulk balance data without running your own node. Prefer this over single-balance lookups when you have 2–10 pairs to check simultaneously, and over full blockchain indexers when you only need current balances rather than historical data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:55:08.146Z","isFirstParty":false,"canonicalSlug":"scanpay-token-balance-batch-a0313919"}