{"uid":"cap_M2kUU_guuo1I4rL4Aiq6g","slug":"evm-smart-contract-read-call-fd67263d","name":"EVM Smart Contract Read Call","description":"Crypto market data and web tools for autonomous agents: read web pages, PDFs and YouTube transcripts, check domains and tokens. Every `/api/v1/*` call is paid per call: **$0.003** for simple reads, **$0.005-$0.01** for aggregates, **$0.02-$0.03** for token risk checks and reports (USDC or USDT). Each route's price is in `x-payment-info`.\n\n**x402 agents:** pay automatically. The 402 response carries a standard `PAYMENT-REQUIRED` header (x402 v2, USDC on Base or Solana, USDT on Solana); retry with `PAYMENT-SIGNATURE`.\n\n**Manual (legacy) flow:** call the endpoint, read the HTTP 402 JSON (`pay_to`, `asset`, `price`), send the USDT transfer, then repeat the call with header `X-Payment-Tx: <signature>`. One signature pays for one call; signatures older than the `max_tx_age_seconds` value are rejected.\n\nMachine-readable spec: `/openapi.json`. LLM summary: `/llms.txt`. MCP server: `POST /mcp`.","url":"https://194-28-85-99.sslip.io/api/v1/evm/call?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":["to","sig"],"properties":{"to":{"type":"string"},"sig":{"type":"string"},"args":{"type":"string"},"block":{"type":"string"},"chain":{"type":"string"},"returns":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","decoded":[4123456789012345],"function":"totalSupply()","selector":"0x18160ddd","result_hex":"0x..."}},"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":"down","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_H6XDZWHissZy49Tvx4Ycq","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":"Executes a read-only call to an EVM smart contract function on a specified chain and returns the decoded result","exampleAgentPrompt":"Can you call the totalSupply() function on the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on the Base chain and give me the decoded result?","exampleUseCases":[{"title":"Check ERC20 token total supply","prompt":"Call the totalSupply() function on the token contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base and return the decoded supply value."},{"title":"Query wallet token balance on-chain","prompt":"Read the balanceOf(address) function on the WETH contract at 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 on Ethereum for address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — what's the balance?"},{"title":"Fetch contract state at historical block","prompt":"Call the getReserves() function on the Uniswap V2 pair contract at 0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc on Ethereum at block 17000000 and decode the result."}],"resultDescription":"Returns a JSON object containing the chain identifier, decoded return values as an array, the function signature called, the 4-byte selector, and the raw hex result from the contract call.","failureModes":["Invalid contract address returns an error or empty result","Unsupported chain identifier causes a 400 error","Malformed function signature (sig) causes decoding failure","Arguments (args) not matching function ABI cause revert","Block number too far in the past may be unavailable depending on node","Payment not provided or invalid signature causes HTTP 402 response","Signature reuse or expired tx age causes payment rejection"],"whenToPreferThis":"Use this endpoint when you need to query on-chain EVM smart contract state without signing a transaction — ideal for reading balances, supplies, prices, or any view/pure function. Prefer this over generic blockchain RPC providers when you want a pay-per-call model with no API key setup and automatic x402 payment support. Best for autonomous agents that need on-demand contract reads across multiple EVM chains including Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T05:28:44.027Z","isFirstParty":false,"canonicalSlug":"evm-smart-contract-read-call-fd67263d"}