{"uid":"cap_g27gBFyNNot75lBNBCInx","slug":"contract-read-view-call-on-arc-08e576dd","name":"Contract Read (View Call) on Arc","description":"Contract read on Arc: one view call on any contract, decoded, with block and time. ?address=0x...&fn=function balanceOf(address) view returns (uint256)&args=[\"0x...\"] (args a JSON array, optional; &block=N for a past block). For agents that check owner, paused, allowance or a balance before acting, without running an RPC. Only view/pure functions; a revert, a non-contract or a bad signature is refused before payment.","url":"https://apexfaucet.xyz/api/x402/arc-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","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address","fn"],"properties":{"fn":{"type":"string","description":"A view/pure function signature, e.g. function balanceOf(address) view returns (uint256)."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"The contract to read."}}}}},"output":{"type":"object"}}},"responseSchema":null,"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_XL_xj6J2ZGigINp_cncSp","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 single view/pure function call on any Arc blockchain contract and returns the decoded result with block number and timestamp, without requiring an RPC connection.","exampleAgentPrompt":"Check the USDC allowance that wallet 0xAbCd...1234 has granted to 0xDeFg...5678 on the Arc contract at 0x1234...abcd — use the function signature 'function allowance(address,address) view returns (uint256)'.","exampleUseCases":[{"title":"Check token balance before a trade","prompt":"Before I swap, check the balance of wallet 0xAbCd...1234 on the Arc token contract at 0x9999...aaaa — call 'function balanceOf(address) view returns (uint256)' with my wallet address."},{"title":"Verify contract is not paused","prompt":"Is the Arc contract at 0x5678...efgh currently paused? Call the 'function paused() view returns (bool)' function on it so I know before I try to deposit."},{"title":"Read historical contract state at past block","prompt":"What was the owner of the Arc contract at 0xDead...Beef at block 4200000? Use 'function owner() view returns (address)' and pass block=4200000."}],"resultDescription":"Returns the decoded output of the view function call, including the return value(s) mapped to their types, the block number at which the call was executed, and the block timestamp. If the function reverts, the target is not a contract, or the signature is invalid, the call is rejected before payment is charged.","failureModes":["Non-view/non-pure function signature rejected before payment","Address is not a deployed contract — refused before payment","Malformed or incorrect ABI function signature returns error","Function reverts on-chain — refused before payment","Invalid args JSON array format causes request rejection","Requested block number does not exist or is too far in the past"],"whenToPreferThis":"Use this endpoint when an AI agent needs to read on-chain state from an Arc contract without setting up an RPC connection. It is ideal for pre-flight checks (balance, allowance, paused status, ownership) before executing a transaction. The decoded output and included block/time metadata make it immediately usable without additional parsing. Prefer this over raw RPC calls when you want a managed, pay-per-call interface with built-in ABI decoding and pre-payment validation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:34:38.711Z","isFirstParty":false,"canonicalSlug":"contract-read-view-call-on-arc-08e576dd"}