# ChainRead Contract Inspector

> ChainRead Contract Inspector is a paid API for AI agents from chainread.imac2014ville.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Inspects an EVM smart contract address on Base or Ethereum mainnet to determine if it's a contract, its code size, whether it's a proxy, detected traits (e.g. ERC-20), and key function selectors.

## Facts

- Endpoint: GET https://chainread.imac2014ville.workers.dev/contract?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainread-contract-inspector-cc07c723
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__lgm62yuL5dlPs8Uzil45

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 chainread-contract-inspector-cc07c723
```

Example prompt: Can you inspect the contract at 0x4200000000000000000000000000000000000006 on Base and tell me if it's a proxy, what traits it has, and what key functions it exposes?

## When to prefer this

Choose this endpoint when you need lightweight, low-cost contract inspection on Base or Ethereum mainnet without setting up an API key or running your own RPC node. It is ideal for agents that need to quickly verify whether an address is a contract, detect ERC-20 compatibility, check for proxy patterns, or enumerate key function selectors — all for $0.002 USDC per call via x402 micropayment. Prefer this over Etherscan or Alchemy when you want a simple pay-per-call model with no account registration.

## Known failure modes

- Address not found or not a contract — isContract returns false
- Invalid address format — likely 400 or error response
- Unsupported chain value — only 'base' and 'ethereum' are valid
- Payment not processed — x402 payment required before data is returned
- Network timeout or RPC error for the underlying chain
- Empty code at address (EOA) — codeSize 0, isContract false

## How this service works

Cheap EVM read utilities for AI agents on Base and Ethereum mainnet: gas and fees, blocks, balances, ERC-20 metadata, contract inspection, transaction status, ENS/Basename resolution, bulk balances. No API key: pay USDC on Base per call via x402.

## Output

Returns a JSON object with: ok (boolean), chain (base or ethereum), address (the inspected address), isContract (boolean), isProxy (boolean), codeSize (integer bytes), traits (array of detected standards like 'erc20-like'), and selectorsOfInterest (array of {selector, signature} objects for known function signatures).

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum"
       ],
       "type": "string",
       "description": "Chain to read (default base)"
      },
      "address": {
       "type": "string",
       "description": "Address to inspect (0x…)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "chain": "base",
  "traits": [
   "erc20-like"
  ],
  "address": "0x4200000000000000000000000000000000000006",
  "isProxy": false,
  "codeSize": 2200,
  "isContract": true,
  "selectorsOfInterest": [
   {
    "selector": "0xa9059cbb",
    "signature": "transfer(address,uint256)"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainread-contract-inspector-cc07c723/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainread.imac2014ville.workers.dev](https://www.zero.xyz/host/chainread.imac2014ville.workers.dev/llms.txt)