{"uid":"cap_q73-aEkWnbT7QvJ1NG4IF","slug":"speraxos-contract-explorer-read-contract-635eb8a7","name":"SperaxOS Contract Explorer – Read Contract","description":"AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.","url":"https://chat.sperax.io/api/x402/tools/contract-explorer/readContract?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"args":{"type":"array","items":{"type":"string"},"description":"Arguments for the function call as an array of strings"},"chain":{"type":"string","description":"Chain name: ethereum, arbitrum, polygon, base, optimism, avalanche, bsc. Defaults to ethereum."},"address":{"type":"string","description":"EVM contract address (0x…)"},"functionName":{"type":"string","description":"Name of the view/pure function to call (e.g. \"totalSupply\", \"balanceOf\", \"owner\")"}}},"responseSchema":null,"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_13PX_Fk71B7eK14JUYCPo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0xD74f5255D557944cf7Dd0E45FF521520002D5748","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calls a read-only (view/pure) function on any EVM smart contract across multiple chains and returns the on-chain result","exampleAgentPrompt":"What is the total supply of the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum? Call the totalSupply function with no arguments.","exampleUseCases":[{"title":"Token supply check for ERC-20","prompt":"What's the current total supply of the token at contract address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum? Use the totalSupply function with no arguments."},{"title":"Wallet balance on DeFi contract","prompt":"How many tokens does wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 hold according to the contract 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum? Call balanceOf with that wallet address as the argument."},{"title":"Check contract owner on Polygon","prompt":"Who is the current owner of the contract at 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 on Polygon? Call the owner function with no arguments."}],"resultDescription":"Returns the decoded return value(s) from the specified view or pure smart contract function — such as a token balance, total supply, owner address, protocol parameter, or any other on-chain state variable — as structured data reflecting the contract's current on-chain state.","failureModes":["Invalid contract address — returns error if address is not a valid EVM 0x address","Function not found — returns error if the specified functionName does not exist on the contract","Wrong argument types or count — call reverts if args do not match the function signature","Unsupported chain — error if chain name is not one of the eight supported values","Contract not deployed on specified chain — returns error if address has no code on that chain","Payment failure — x402 payment of 0.005 USDC must succeed before the call is executed"],"whenToPreferThis":"Use this endpoint when you need to read live on-chain state from any EVM smart contract without setting up a full node, RPC provider, or API key — especially for DeFi analytics, token metadata, protocol parameter inspection, or wallet balance checks across Ethereum, Base, Arbitrum, Polygon, Optimism, Avalanche, or BSC. Prefer it over generic blockchain RPC tools when you want a single pay-per-call HTTP API with no credential management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T02:43:59.394Z","isFirstParty":false,"canonicalSlug":"speraxos-contract-explorer-read-contract-635eb8a7"}