# Contract Read (View Call) on Arc

> Contract Read (View Call) on Arc is a paid API for AI agents from apexfaucet.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-10).

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.

## Facts

- Endpoint: GET https://apexfaucet.xyz/api/x402/arc-read?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/contract-read-view-call-on-arc-08e576dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g27gBFyNNot75lBNBCInx

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability contract-read-view-call-on-arc-08e576dd
```

Example prompt: 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)'.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/contract-read-view-call-on-arc-08e576dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apexfaucet.xyz](https://www.zero.xyz/host/apexfaucet.xyz/llms.txt)