# ETH Mainnet Contract ABI

> ETH Mainnet Contract ABI is a paid API for AI agents from api.arysphere.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-17).

Fetches the ABI (Application Binary Interface) of an Ethereum mainnet smart contract by its address, including proxy detection and implementation details.

## Facts

- Endpoint: GET https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_contract_abi?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eth-mainnet-contract-abi-1eb03995
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7jBcX559ZpikD1Qm78QzW

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 eth-mainnet-contract-abi-1eb03995
```

Example prompt: Can you get me the ABI for the Ethereum mainnet contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48? I need to know its functions and whether it's a proxy contract.

## When to prefer this

Choose this endpoint when you specifically need the ABI of an Ethereum mainnet contract and want proxy detection and implementation resolution included. Use the sibling Base Contract ABI endpoint for Base network contracts. Prefer this over generic Etherscan API wrappers when operating within the x402 micropayment ecosystem or when you need a single clean JSON response with proxy metadata bundled in.

## Known failure modes

- Invalid address format (not 0x + 40 hex) results in a validation error
- Contract address not found or not deployed on Ethereum mainnet returns no ABI
- Unverified contract with no published ABI returns empty or null ABI
- Network or provider timeout results in a failed response
- Non-mainnet addresses (e.g. Base or Gnosis contracts) may return no result on this endpoint

## How this service works

ARYSPHERE sells AI-written verdicts on Base token contracts (a grade, a one-liner, a roast and the contract's facts) and Base/Ethereum chain reads, paid per call in USDC on Base over x402 v2. No account and no API key.

## Output

Returns a JSON object containing the contract's full ABI array, whether the ABI was an exact match, proxy detection results (including proxy type and implementation addresses), the contract address, and verification status. If the contract is a proxy, the resolved implementation ABI and implementation contract address are included.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "contract, 0x + 40 hex"
      }
     }
    }
   },
   "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": "ethereum",
  "method": "abi",
  "result": {
   "abi": [
    {
     "name": "name",
     "type": "function",
     "inputs": [],
     "outputs": [
      {
       "name": "",
       "type": "string"
      }
     ],
     "payable": false,
     "constant": true,
     "stateMutability": "view"
    },
    {
     "name": "deprecate",
     "type": "function",
     "inputs": [
      {
       "name": "_upgradedAddress",
       "type": "address"
      }
     ],
     "outputs": [],
     "payable": false,
     "constant": false,
     "stateMutability": "nonpayable"
    }
   ],
   "match": "match",
   "proxy": {
    "isProxy": false,
    "proxyType": null,
    "implementations": []
   },
   "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
   "isProxy": false,
   "verified": true,
   "implementation": null
  },
  "service": "x402_eth_reads_v1.eth_mainnet_contract_abi"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eth-mainnet-contract-abi-1eb03995/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arysphere.com](https://www.zero.xyz/host/api.arysphere.com/llms.txt)
