{"uid":"cap_3G4yoQZlCXYZ8uIWxeA_0","slug":"vextorium-evm-contract-read-782b1b0b","name":"Vextorium EVM Contract Read","description":"Call any read-only (view) function of an EVM contract from its signature, e.g. balanceOf(address)(uint256), with arguments, and get the decoded result. Supports address, bool, intN/uintN, bytesN, string, bytes and arrays. Read-only: nothing is signed or sent.","url":"https://api.vextorium.com/v1/contract-read?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["contract","function"],"properties":{"network":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string"},"contract":{"type":"string"},"function":{"type":"string","description":"Signature with output types, e.g. totalSupply()(uint256)"},"arguments":{"type":"array","description":"Arguments in order"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"result":{"type":["array","null"],"items":{"type":["null","string"]}},"network":{"type":["string","null"]},"contract":{"type":["string","null"]},"function":{"type":["string","null"]},"selector":{"type":["string","null"]},"result_hex":{"type":["string","null"]}}}}}}},"responseSchema":{"type":"json","example":{"result":["USD Coin"],"network":"base","contract":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","function":"name()","selector":"0x06fdde03","result_hex":"0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000855534420436f696e000000000000000000000000000000000000000000000000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AiHS6Ac-C7ij8uVjUM2XU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":null,"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 by function signature and returns decoded results without signing or broadcasting a transaction.","exampleAgentPrompt":"What is the token balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base? Call balanceOf(address)(uint256) with that wallet address.","exampleUseCases":[{"title":"Check ERC-20 token balance on-chain","prompt":"What's the USDC balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on the Base network? The USDC contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — call balanceOf(address)(uint256) with that address."},{"title":"Fetch NFT contract owner on Ethereum","prompt":"Who is the owner of the NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13d on Ethereum? Call the owner()(address) view function and return the decoded address."},{"title":"Query DeFi protocol total supply on Arbitrum","prompt":"What's the total supply of the Aave aUSDC token at 0x625E7708f30cA75bfd92586e17077590C60eb4cD on Arbitrum? Use totalSupply()(uint256) to get the result."}],"resultDescription":"A JSON object containing the decoded return values as an array of strings, the network, contract address, function signature, 4-byte function selector, and the raw ABI-encoded hex response from the node.","failureModes":["Invalid function signature format returns a parsing error","Contract address does not exist on the specified network returns an RPC error","Wrong argument types or count cause ABI decoding failure","Unsupported network name returns a validation error","Non-view (state-changing) functions cannot be called and will fail","Network RPC unavailability causes a timeout or upstream error"],"whenToPreferThis":"Choose this endpoint when you need to read on-chain state from any EVM-compatible contract (Base, Ethereum, Arbitrum, Optimism, Polygon) using only the function signature — no ABI file, no wallet, no RPC node setup required. Ideal for agents that need to query token balances, NFT ownership, protocol state, or any view function in a single HTTP call without managing Web3 infrastructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:55:28.482Z","isFirstParty":false,"canonicalSlug":"vextorium-evm-contract-read-782b1b0b"}