{"uid":"cap_3D6dqV3FlkYfXThKOU6rp","slug":"moneytools-contract-read-eth-call-61c72f31","name":"MoneyTools Contract Read (eth_call)","description":"Read any contract (eth_call): Call any view function with a human signature and args, e.g. balanceOf(address) returns (uint256); decoded result. Optional historical block. Free tier 10/day; then $0.001 via x402 (HTTP 402 + PAYMENT-REQUIRED) or X-API-Key credits. Not charged on failure. $0.001 USDC per call via x402 on Base. Run by MoneyTools.","url":"https://tools.moneytools.dev/v1/contract-read?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":{"const":"GET"},"queryParams":{"type":"object","required":["chain","address","signature"],"properties":{"args":{"type":"string","examples":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],"description":"comma list or JSON array"},"block":{"type":"string","description":"block number (default latest)"},"chain":{"type":"string","examples":["base"],"description":"chain: base, ethereum, arbitrum, optimism, polygon, bsc, avalanche"},"address":{"type":"string","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"description":"contract"},"signature":{"type":"string","examples":["balanceOf(address) returns (uint256)"],"description":"function signature with returns"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","properties":{"payment":{"type":"object","properties":{"charged":{"type":"boolean"},"network":{"type":"string"},"amountUsd":{"type":"string"},"transaction":{"type":["string","null"]}}},"freeTier":{"type":"object"},"_moneytools":{"type":"object","description":"optional plan / partner hints"}},"description":"Tool-specific JSON result (see llms.txt / openapi.json). Always includes payment info.","additionalProperties":true}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_osG0xuA_hfBrFRJI6WyVt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calls any read-only (view) function on an EVM smart contract using a human-readable function signature and returns the decoded result, with optional historical block support.","exampleAgentPrompt":"What's the USDC balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base? The USDC contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and the function is balanceOf(address) returns (uint256).","exampleUseCases":[{"title":"ERC-20 token balance check","prompt":"Can you check how many USDC tokens the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds on Base? The USDC contract address is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, function is balanceOf(address) returns (uint256)."},{"title":"Historical on-chain state lookup","prompt":"What was the totalSupply of the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Ethereum at block 19000000? The function is totalSupply() returns (uint256)."},{"title":"DeFi protocol on-chain data query","prompt":"Call the getReserves() returns (uint112,uint112,uint32) function on the Uniswap V2 pair contract 0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc on Ethereum so I can see the current liquidity reserves."}],"resultDescription":"A JSON object containing the decoded return value(s) of the smart contract view function call, plus a payment object indicating whether a charge was made (boolean), network, amount in USD, and transaction hash. Also includes free tier usage metadata and optional plan/partner hints under _moneytools.","failureModes":["Invalid or malformed contract address returns an error","Wrong or mismatched function signature causes a revert or decode failure","Unsupported chain name returns a validation error","Requested block number does not exist or is too old returns an error","Free tier exhausted (10/day) triggers HTTP 402 requiring x402 micropayment or API key","Contract has no matching function (function not found) returns a call failure","Network congestion or RPC timeout causes a temporary error","Arguments list doesn't match signature arity causes a decode error"],"whenToPreferThis":"Use this endpoint when you need to read on-chain EVM contract state using a human-readable function signature without setting up a full Web3 stack or managing RPC providers. It is ideal for lightweight, one-off contract reads across multiple chains (Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche), including historical block queries. Prefer it over running your own node or using raw JSON-RPC when you want decoded results and pay-per-call pricing with no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-05T12:43:43.781Z","isFirstParty":false,"canonicalSlug":"moneytools-contract-read-eth-call-61c72f31"}