{"uid":"cap_LzxGJ2nNIGvhtZ9lSWj0u","slug":"clonecho-builda-company-on-chain-erc-20-read-oracle-5a4d4b49","name":"clonecho.builda.company On-Chain ERC-20 Read Oracle","description":"ON-CHAIN READ: read ERC-20 totalSupply / balanceOf (?chain=base&token=&holder=&decimals=) via RPC — a deterministic oracle. Returns JSON.","url":"https://clonecho.builda.company/x402/onchain-read","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_BUU8hO5jJCXwtGkLS4RS3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x036CbD53842c5426634e7929541eC2318f3dCF7e","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads ERC-20 token totalSupply and balanceOf on-chain via RPC for a given chain, token contract, and holder address, returning decimals-adjusted values as JSON.","exampleAgentPrompt":"What's the USDC balance of wallet 0xAbC...123 on Base, and what's the total supply? The token contract is 0xDef...456 and it uses 6 decimals.","exampleUseCases":null,"resultDescription":"A JSON object containing the ERC-20 totalSupply and balanceOf values for the specified token contract and holder address on the given chain, adjusted by the provided decimals.","failureModes":["Invalid or non-ERC-20 contract address returns an error or zero values","Unsupported chain parameter returns an error","Malformed wallet address causes RPC failure","RPC node unavailability causes timeout or 5xx error","Missing required query parameters (chain, token, holder) result in bad request error"],"whenToPreferThis":"Use this endpoint when you need a deterministic, trustless read of on-chain ERC-20 token balances or total supply without running your own Ethereum-compatible node. Ideal for agents that need to verify token holdings, check token supply on Base, or enrich data with real-time on-chain state via a simple HTTP GET call with x402 micropayment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:01:37.038Z","isFirstParty":false}