# Crypto Contract Info Lookup (x402)

> Crypto Contract Info Lookup (x402) is a paid API for AI agents from kr-x402-mvp.kgy5612.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Returns on-chain contract metadata for a given EVM address on Base or Ethereum: token info, proxy structure, admin flags, and risk indicators.

## Facts

- Endpoint: GET https://kr-x402-mvp.kgy5612.workers.dev/crypto/contract-info?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-contract-info-lookup-x402-44f3172b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XXlj7YTDGro-OG74jQ--0

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 crypto-contract-info-lookup-x402-44f3172b
```

Example prompt: Can you look up the contract info for 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to know if it's a proxy, who owns it, and whether there are any admin risk flags?

## When to prefer this

Use this endpoint when an AI agent needs to understand the nature and risk profile of an unknown EVM contract address before interacting with it — particularly for pre-trade safety checks, token metadata resolution, or proxy/admin structure analysis. It covers Base and Ethereum mainnet with no API key required, charging $0.002 USDC per call via x402. Prefer this over general blockchain explorers when you need a structured, machine-readable response optimized for agent consumption, with built-in next-step suggestions linking to sibling endpoints like token-risk or allowance.

## Known failure modes

- Invalid address format (not a valid 0x hex address) — schema validation error
- Address not found on specified chain — may return is_contract: false with minimal data
- Chain param not one of 'base' or 'eth' — rejected by schema enum validation
- Payment failure via x402 (insufficient USDC balance on Base) — 402 response with payment details
- RPC timeout or node unavailability — upstream error response
- Rate limiting or worker capacity issues on Cloudflare edge

## How this service works

Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.

## Output

A JSON object containing: contract kind (ERC20, EOA, etc.), token metadata (name, symbol, decimals, total supply), proxy details (proxy type, admin address, implementation address), ownership info and whether ownership is renounced, risk flags (e.g. upgradeable_proxy, has_owner, admin_can_change_logic), native ETH balance, code size in bytes, the chain and chain ID, a timestamp, and a 'next' array of suggested sibling endpoint URLs for further analysis.

## 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",
        "eth"
       ],
       "type": "string",
       "description": "base (default) or eth mainnet"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "examples": [
        "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
       ],
       "description": "Address to inspect"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "ERC20",
  "next": [
   "/crypto/token-risk?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "/crypto/allowance?owner=&spender="
  ],
  "safe": null,
  "chain": "base",
  "flags": [
   "upgradeable_proxy",
   "has_owner",
   "admin_can_change_logic"
  ],
  "owner": "0x...",
  "proxy": {
   "type": "ZEPPELINOS_LEGACY",
   "admin": "0x4fc7850364958d97b4d3f5a08f79db2493f8ca44",
   "beacon": null,
   "is_proxy": true,
   "implementation": "0x2ce6311ddae708829bc0784c967b7d77d19fd779"
  },
  "token": {
   "name": "USD Coin",
   "symbol": "USDC",
   "decimals": 6,
   "total_supply": 4100000000
  },
  "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "summary": "ERC20 USDC behind ZEPPELINOS_LEGACY proxy, has owner",
  "chain_id": 8453,
  "checked_at": "2026-10-30T03:40:00Z",
  "interfaces": {
   "erc165": false,
   "erc721": false,
   "erc1155": false
  },
  "is_contract": true,
  "native_balance": 0,
  "code_size_bytes": 1852,
  "owner_renounced": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-contract-info-lookup-x402-44f3172b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kr-x402-mvp.kgy5612.workers.dev](https://www.zero.xyz/host/kr-x402-mvp.kgy5612.workers.dev/llms.txt)