# EVM Contract Introspection

> EVM Contract Introspection is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Inspects an EVM contract address to determine if it is a contract, whether it is a proxy, and whether it is a token, returning full metadata.

## Facts

- Endpoint: POST https://twin.unykorn.org/evm-contract?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/evm-contract-introspection-b16170b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3w3B2HMZLkpy8IwegZTkT

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 evm-contract-introspection-b16170b1 -d '<json body>'
```

Example prompt: Can you check if the address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum is a smart contract, whether it's a proxy, and if so what token it represents?

## When to prefer this

Use this endpoint when you need to quickly classify an unknown EVM address across major chains (Ethereum, Base, Polygon, Arbitrum, Optimism) — especially when you need all three signals (is it a contract, is it a proxy, is it a token) in a single call. Prefer this over manual RPC calls or block explorer scraping when operating in an agentic context where structured, machine-readable output and pay-per-call pricing are preferred. It is especially useful for DeFi due diligence, contract auditing pipelines, or token discovery workflows.

## Known failure modes

- Address is not a contract (EOA) — is_contract returns false with no token or proxy data
- Invalid address format — input validation error if not a valid 0x hex address
- Unsupported chain — error if chain is not in the allowed enum
- Contract exists but is not a token — token field absent or null
- Proxy detection inconclusive — proxy.detected false even if pattern exists but is non-standard
- Network timeout or RPC failure — call may return an error or timeout
- Insufficient payment — x402 payment not accepted, returns 402

## How this service works

EVM contract introspection — is it a contract, is it a proxy, is it a token — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object indicating whether the address is a contract, whether a proxy pattern was detected (including the proxy standard like ZeppelinOS and the implementation address), and if the contract is a token, its name, symbol, decimals, ERC20 compatibility flag, and total supply. Also returns the chain ID, bytecode size, an evidence hash, and a payment receipt.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "chain": {
     "enum": [
      "ethereum",
      "base",
      "polygon",
      "arbitrum",
      "optimism"
     ],
     "type": "string"
    },
    "address": {
     "type": "string",
     "pattern": "^0x[0-9a-fA-F]{40}$"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "evm-contract",
  "chain": "base",
  "proxy": {
   "detected": true,
   "standard": "zeppelinos",
   "implementation": "0x2ce6…d779"
  },
  "token": {
   "name": "USD Coin",
   "symbol": "USDC",
   "decimals": 6,
   "erc20_like": true,
   "total_supply": "4285515964.300967"
  },
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.005,
   "receipt_id": "g402-<16hex>"
  },
  "chain_id": 8453,
  "is_contract": true,
  "evidence_hash": "sha256:<64hex>",
  "bytecode_bytes": 1852
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/evm-contract-introspection-b16170b1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)