# EVM Address Type Detector

> EVM Address Type Detector is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Detects whether an Ethereum/EVM address is an EOA, generic contract, Gnosis Safe multisig, ERC20 token, ERC721 NFT, or upgradeable proxy via on-chain probing, with an interaction hint

## Facts

- Endpoint: GET https://api.x402node.dev/chain/address-type
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/evm-address-type-detector-cb63f598
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NLZp2S0-t2Z9MvFEMxgiB

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-address-type-detector-cb63f598
```

Example prompt: Before I send funds, can you check what type of address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 is — whether it's a regular wallet, a Gnosis Safe, an ERC20 token, a proxy, or something else — so I know how to handle it?

## When to prefer this

Use this endpoint before any transaction or token interaction when you do not know the address type. It is especially valuable when building agents that must handle EOAs, multisigs, token contracts, and proxies differently — preventing errors like sending ETH directly to a non-payable contract or failing to batch-approve a Safe. Prefer this over manual ABI inspection when you need a fast, single-call classification with an actionable interaction hint.

## Known failure modes

- Invalid or malformed address returns an error
- Network timeout if on-chain RPC is slow or unavailable
- Ambiguous contracts that match multiple patterns may return a best-guess classification
- Very new contracts may not yet have enough on-chain data to classify accurately
- Non-EVM chains are not supported

## How this service works

Detect whether an address is an EOA, generic contract, Gnosis Safe multisig, ERC20 token, ERC721 NFT or upgradeable proxy via on-chain probing, with an interaction hint - critical for agents because each type requires completely different handling before transacting. address type, is contract or eoa, multisig detection, safe wallet, contract type, eoa or contract Accepts payment on Base or Solana — either network works.

## Output

Returns the address classification (EOA, generic contract, Gnosis Safe multisig, ERC20 token, ERC721 NFT, or upgradeable proxy) along with an interaction hint that advises how the agent should handle the address before transacting.

## Example request

```json
{
 "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
}
```

## 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": {
       "type": "string",
       "description": "ethereum, base (default), arbitrum, optimism, polygon"
      },
      "address": {
       "type": "string",
       "description": "Address to classify (required)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/evm-address-type-detector-cb63f598/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)