# AllTheBot Contract or Wallet Checker

> AllTheBot Contract or Wallet Checker is a paid API for AI agents from api.zkrobotics.fr, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Determines whether a Base network address is an EOA wallet, an EIP-7702 delegated wallet, or a smart contract, and returns bytecode size, ETH balance, and ERC-20 symbol.

## Facts

- Endpoint: GET https://api.zkrobotics.fr/x402/base/contract?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/allthebot-contract-or-wallet-checker-a2613b07
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_p7iVYKokrhrei4igSs1VF

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 allthebot-contract-or-wallet-checker-a2613b07
```

Example prompt: Before I send funds, can you check if 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base is a wallet or a smart contract, and tell me its ETH balance and whether it's an ERC-20 token?

## When to prefer this

Use this endpoint when you need a cheap, fast pre-flight safety check on any Base address before sending funds — especially useful when the address origin is unknown, when you want to distinguish EIP-7702 delegated wallets from regular EOAs, or when you need to confirm whether an address is an ERC-20 token contract. Prefer this over a generic Ethereum block explorer API when you specifically target Base mainnet and want a single call that bundles type classification, bytecode size, ETH balance, and ERC-20 metadata.

## Known failure modes

- Invalid address format (not matching ^0x[0-9a-fA-F]{40}$) returns a validation error
- Address not found or RPC timeout may return an error or empty result
- Non-ERC-20 contracts will return null/empty ERC-20 fields
- Payment failure (x402) if USDC balance insufficient

## How this service works

Pay-per-call APIs for AI agents over x402: token safety reports, Base and Ethereum on-chain reads, crypto prices, domain checks (DNS, WHOIS, SSL, email), finance data (FX, SEC), worldwide weather forecasts, France alerts, text AI, fun content. USDC on Base, no account, no API key.

## Output

Returns a JSON object containing the address type (EOA, EIP-7702 delegated wallet, or contract), bytecode size in bytes, ETH balance as a decimal string, ERC-20 symbol and decimals if the address is a token contract, the address itself, and the network name (base).

## 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",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "eth": "0.009800646158085843",
  "type": "contract",
  "erc20": {
   "symbol": "USDC",
   "decimals": 6
  },
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "network": "base",
  "bytecode_size": 1852
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allthebot-contract-or-wallet-checker-a2613b07/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zkrobotics.fr](https://www.zero.xyz/host/api.zkrobotics.fr/llms.txt)
