{"uid":"cap_t6BGI5YYI3ffKhHt-qIgm","slug":"chainread-read-contract-5487dea0","name":"ChainRead Read-Contract","description":"Call any view/pure function with a human-readable signature on Ethereum, Base, Arbitrum, Optimism, Polygon or BSC: decoded result, raw hex, block number, chain id; 422 with revert reason on revert.","url":"https://chainread.genexxis.com/read-contract?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"args":{"type":"array","description":"Arguments in order; integers may be strings"},"chain":{"type":"string","description":"ethereum (default), base, arbitrum, optimism, polygon, bsc or chain id"},"address":{"type":"string","description":"Deployed contract address (0x...)"},"blockTag":{"type":"string","description":"latest (default), safe, finalized, earliest, pending or a block number (alias: block)"},"function":{"type":"string","description":"Human-readable signature, e.g. \"balanceOf(address) view returns (uint256)\"; the \"function \" prefix is optional; include returns (...) to decode"}}},"responseSchema":{"type":"json","example":{"raw":"0x0000000000000000000000000000000000000000000000000000000000000006","args":[],"asOf":"2026-10-25T03:50:00.000Z","chain":"base","result":6,"source":"eth_call via public Base RPC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chainId":8453,"blockTag":"latest","function":"decimals() returns (uint8)","blockNumber":"37412345","stateMutability":"view"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CINdsMsu0-ZhJAm8iJYcj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 eth_call on a deployed smart contract across Ethereum, Base, Arbitrum, Optimism, Polygon, or BNB Chain and returns decoded results","exampleAgentPrompt":"What is the USDC balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum? The USDC contract is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and the function is \"balanceOf(address) view returns (uint256)\".","exampleUseCases":[{"title":"Check token balance on Base","prompt":"What's the USDC balance of wallet 0x1234567890abcdef1234567890abcdef12345678 on Base? The USDC contract there is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, use balanceOf(address) view returns (uint256)."},{"title":"Read DeFi pool reserve data","prompt":"Can you call getReserves() view returns (uint112, uint112, uint32) on the Uniswap V2 pair contract 0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc on Ethereum so I can see the current liquidity reserves?"},{"title":"Fetch NFT ownership on Polygon","prompt":"Who owns token ID 42 on the NFT contract 0x2953399124F0cBB46d2CbACD364cCf1430b41Fa9 on Polygon? The function is \"ownerOf(uint256) view returns (address)\"."}],"resultDescription":"A JSON object containing: the decoded result value (big integers as strings), raw hex response, the function signature used, the block number and chain ID the call was executed against, a UTC timestamp (asOf), the chain name, and the state mutability. If the contract reverts, an HTTP 422 is returned with the decoded revert reason.","failureModes":["Contract revert: HTTP 422 with decoded revert reason string","Invalid contract address: error response indicating bad address format","Unsupported chain: error if chain identifier is not one of the supported networks","Malformed function signature: error if the signature cannot be parsed","RPC unavailability: fallback RPCs attempted; error if all fail","Invalid block tag: error if the block tag is unrecognized or the block does not exist"],"whenToPreferThis":"Use this endpoint when you need to read on-chain state from a deployed EVM smart contract without signing or sending a transaction, across Ethereum, Base, Arbitrum, Optimism, Polygon, or BNB Chain. It is ideal for agents that need decoded, human-readable results from view or pure functions using human-readable ABI signatures rather than raw ABI JSON. Prefer /multicall sibling if you need up to 20 reads batched in one request. Prefer the /token sibling for standard ERC-20/ERC-721/ERC-1155 metadata, and /resolve for ENS or Basename lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:04:26.857Z","isFirstParty":false,"canonicalSlug":"chainread-read-contract-5487dea0"}