# Onchain Query API – EVM Wallet Snapshot

> Onchain Query API – EVM Wallet Snapshot is a paid API for AI agents from chain.cyberwarex.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Returns a wallet snapshot for any EVM address on major chains, including native balance, USDC balance, transaction count, contract-or-EOA flag, and USD values — no RPC keys needed.

## Facts

- Endpoint: GET https://chain.cyberwarex.com/wallet
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/onchain-query-api-evm-wallet-snapshot-af788de8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w8imuXLqarymJl4v63Ayh

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 onchain-query-api-evm-wallet-snapshot-af788de8
```

Example prompt: Can you pull the full wallet snapshot for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum — I need the native ETH balance, USDC balance, transaction count, and whether it's a contract or a regular wallet?

## When to prefer this

Choose this endpoint when you need a quick, all-in-one wallet snapshot across major EVM chains without managing RPC infrastructure or API keys. It is ideal for agents that need native balance, USDC balance, transaction count, and contract detection in a single call at very low cost ($0.003 USDC). Prefer it over raw RPC calls when simplicity and speed matter more than full historical data access.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain value (not one of base, ethereum, arbitrum, optimism, polygon) returns a validation error
- Address not found or zero-activity wallet may return zeroed balances
- Payment failure (x402 protocol) if USDC micropayment is not completed
- Network timeout if the underlying chain RPC is congested

## How this service works

Wallet snapshot on any major EVM chain (base, ethereum, arbitrum, optimism, polygon): native balance, USDC balance, transaction count, contract-or-EOA flag, USD values. One call, no RPC keys or node infra needed.

## Output

A wallet snapshot object containing the native token balance, USDC balance, transaction count, a boolean or flag indicating whether the address is a smart contract or EOA, and USD-denominated values for the balances — all for the specified EVM chain.

## 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": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
       ],
       "type": "string",
       "default": "base",
       "description": "EVM chain to query."
      },
      "address": {
       "type": "string",
       "pattern": "^0x[a-fA-F0-9]{40}$",
       "description": "Wallet or contract address to inspect."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "usdc": {
       "type": "object",
       "description": "USDC balance and raw 6-decimal amount."
      },
      "chain": {
       "type": "string"
      },
      "native": {
       "type": "object",
       "description": "Native coin balance: symbol, balance, wei, usd (usd null if price feed is down)."
      },
      "address": {
       "type": "string"
      },
      "tx_count": {
       "type": "integer",
       "description": "Outbound transaction count (nonce)."
      },
      "is_contract": {
       "type": "boolean"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/onchain-query-api-evm-wallet-snapshot-af788de8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chain.cyberwarex.com](https://www.zero.xyz/host/chain.cyberwarex.com/llms.txt)