{"uid":"cap_SZbLPxKSLNH7r1gxS-JjJ","slug":"scrapemole-onchain-balances-bb6f00ee","name":"ScrapeMole Onchain Balances","description":"Pay-per-call on-chain data for agents on Base and Ethereum, read directly from chain state: Chainlink USD prices (crypto, stablecoins, FX, metals; 10 per call), ERC-20 token info, wallet balances with USD values, transaction lookup with decoded ERC-20 transfers, ENS and Basename resolution (forward and reverse), gas and fee estimates in USD, and Uniswap v3 DEX prices for long-tail tokens (verify a payment arrived). USDC via x402; failed calls are never charged.\n\nPayments: x402 v2, scheme \"exact\", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://onchain.scrapemole.workers.dev/terms","url":"https://onchain.scrapemole.workers.dev/v1/balances?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":["address"],"properties":{"chain":{"enum":["base","ethereum"],"type":"string","default":"base","description":"Chain."},"tokens":{"type":"string","description":"Comma-separated token symbols (from the default list) or 0x token addresses, max 20. Default: major tokens of the chain."},"address":{"type":"string","examples":["0x4200000000000000000000000000000000000006"],"description":"Wallet or contract address (0x…)."},"includeZero":{"type":"string","default":"false","description":"Also list zero balances (true/false)."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","native":{"symbol":"ETH","balance":"1.2345","priceUsd":3912.45,"valueUsd":4829.92},"tokens":[{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","balance":"250.5","decimals":6,"priceUsd":1,"valueUsd":250.5}],"address":"0x…","totalUsd":5080.42,"blockNumber":36500000,"checkedTokens":9}},"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_CYvEga1YsI1qidZlEK1OK","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":"Returns native ETH and ERC-20 token balances with USD values for a wallet address on Base or Ethereum","exampleAgentPrompt":"What are the current token balances and total USD value for wallet 0x4200000000000000000000000000000000000006 on Base, including ETH and the major tokens?","exampleUseCases":[{"title":"Portfolio snapshot for DeFi user","prompt":"Can you pull all the token balances and their USD values for my wallet 0xAbC123…def on Base? I want to see ETH and all the major tokens, skip anything with a zero balance."},{"title":"Verify payment received in USDC","prompt":"Check whether wallet 0x9999…aaaa on Base has received any USDC — show me its current USDC balance so I can confirm the payment came through."},{"title":"Agent treasury audit on Ethereum","prompt":"Give me a full breakdown of every token held by contract address 0xDeAdBeEf… on Ethereum, including zero balances, so I can audit what the treasury is holding."}],"resultDescription":"A JSON object with the queried address, chain, native ETH balance (with symbol, amount, USD price, and USD value), an array of ERC-20 token balances (symbol, contract address, decimals, balance, USD price, USD value), total portfolio value in USD, number of tokens checked, and the block number at which the data was read.","failureModes":["Invalid or malformed wallet address returns an error (call not charged)","Unsupported chain value returns validation error","Token symbol not in default list and no address provided may result in token not found","Network/RPC timeout may return 5xx error (call not charged)","More than 20 tokens requested returns a validation error"],"whenToPreferThis":"Use this endpoint when you need real-time, on-chain wallet balance data for Base or Ethereum with USD valuations included — especially when you need multiple token balances in one call. Prefer over block explorer scraping or DEX APIs when you need canonical ERC-20 balances with USD prices attached. The pay-per-call model (no subscription) and free-on-failure guarantee make it low-risk for agent workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:42:38.618Z","isFirstParty":false,"canonicalSlug":"scrapemole-onchain-balances-bb6f00ee"}