# SperaxOS Contract Explorer – Read Contract

> SperaxOS Contract Explorer – Read Contract is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Calls a read-only (view/pure) function on any EVM smart contract across multiple chains and returns the on-chain result

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/contract-explorer/readContract?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-contract-explorer-read-contract-635eb8a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_q73-aEkWnbT7QvJ1NG4IF

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 speraxos-contract-explorer-read-contract-635eb8a7 -d '<json body>'
```

Example prompt: What is the total supply of the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum? Call the totalSupply function with no arguments.

## When to prefer this

Use this endpoint when you need to read live on-chain state from any EVM smart contract without setting up a full node, RPC provider, or API key — especially for DeFi analytics, token metadata, protocol parameter inspection, or wallet balance checks across Ethereum, Base, Arbitrum, Polygon, Optimism, Avalanche, or BSC. Prefer it over generic blockchain RPC tools when you want a single pay-per-call HTTP API with no credential management.

## Known failure modes

- Invalid contract address — returns error if address is not a valid EVM 0x address
- Function not found — returns error if the specified functionName does not exist on the contract
- Wrong argument types or count — call reverts if args do not match the function signature
- Unsupported chain — error if chain name is not one of the eight supported values
- Contract not deployed on specified chain — returns error if address has no code on that chain
- Payment failure — x402 payment of 0.005 USDC must succeed before the call is executed

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

Returns the decoded return value(s) from the specified view or pure smart contract function — such as a token balance, total supply, owner address, protocol parameter, or any other on-chain state variable — as structured data reflecting the contract's current on-chain state.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "args": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Arguments for the function call as an array of strings"
  },
  "chain": {
   "type": "string",
   "description": "Chain name: ethereum, arbitrum, polygon, base, optimism, avalanche, bsc. Defaults to ethereum."
  },
  "address": {
   "type": "string",
   "description": "EVM contract address (0x…)"
  },
  "functionName": {
   "type": "string",
   "description": "Name of the view/pure function to call (e.g. \"totalSupply\", \"balanceOf\", \"owner\")"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-contract-explorer-read-contract-635eb8a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)