# ISHOB Contract ABI Lookup

> ISHOB Contract ABI Lookup is a paid API for AI agents from api.ishob.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-14).

Returns the verified smart-contract ABI (and optional Solidity/Vyper source) for a given contract address on Ethereum, Base, Arbitrum, Optimism, Polygon, or BNB Chain, including proxy resolution to the implementation ABI.

## Facts

- Endpoint: GET https://api.ishob.com/v1/crypto/contract-abi?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ishob-contract-abi-lookup-9feef51c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1MUrMcwsFmRjHE76zSdzX

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 ishob-contract-abi-lookup-9feef51c
```

Example prompt: Can you fetch the verified ABI for the contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum, and resolve the proxy to show me the implementation's read and write functions?

## When to prefer this

Prefer this endpoint when you need authoritative, open-registry-verified ABI data (from Sourcify) across multiple EVM chains including Base, Arbitrum, Optimism, Polygon, and BNB Chain, especially when proxy resolution to the implementation ABI is required. It is ideal for agent workflows that need to understand contract interfaces programmatically without relying on Etherscan API keys. The pay-per-call x402 model makes it cost-effective for low-volume or sporadic lookups.

## Known failure modes

- 404 returned (and not charged) if the contract is not verified in the Sourcify registry
- Invalid address format (not a 40-char hex) causes validation error
- Unsupported chain value returns schema validation error
- Contract exists but has no verified source — ABI may be partial or unavailable
- Proxy resolution may fail if the implementation address cannot be determined on-chain

## How this service works

Verified smart-contract ABI (+ optional Solidity/Vyper source) for Ethereum, Base, Arbitrum, Optimism, Polygon and BNB Chain from the open Sourcify registry: compiler, deployment, read/write function and event signatures, and proxy resolution to the implementation ABI. Unverified contracts return 404 (not charged).

## Output

A JSON object containing the contract ABI array, contract name, chain, compiler version, verification status, a summary of read/write functions and event signatures, and — when resolve_proxy is true — the proxy type and implementation contract's ABI and address. Optionally includes verified Solidity/Vyper source files. Returns 404 (not charged) for unverified contracts.

## 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": [
      "chain",
      "address"
     ],
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base",
        "arbitrum",
        "optimism",
        "polygon",
        "bsc"
       ],
       "type": "string",
       "description": "EVM chain"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Contract address"
      },
      "resolve_proxy": {
       "type": "boolean",
       "default": true,
       "description": "Also return the implementation ABI of a proxy"
      },
      "include_source": {
       "type": "boolean",
       "default": false,
       "description": "Include verified source files (up to 600k characters)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "abi": [
   "..."
  ],
  "name": "FiatTokenProxy",
  "chain": "base",
  "proxy": {
   "type": "ZeppelinOSProxy",
   "is_proxy": true,
   "implementations": [
    {
     "abi": [
      "..."
     ],
     "name": "FiatTokenV2_2",
     "address": "0x2Ce6..."
    }
   ]
  },
  "summary": {
   "read": [
    "admin()",
    "implementation()"
   ],
   "write": [
    "upgradeTo(address)"
   ],
   "events": [
    "Upgraded(address)"
   ]
  },
  "compiler": "0.6.12+commit.27d51765",
  "verified": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ishob-contract-abi-lookup-9feef51c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ishob.com](https://www.zero.xyz/host/api.ishob.com/llms.txt)