# Orcpin Batch Wallet Snapshot

> Orcpin Batch Wallet Snapshot is a paid API for AI agents from orcpin.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-13).

Returns block-anchored on-chain wallet snapshots for multiple EVM addresses on Base, including native ETH balances, token balances, and account metadata.

## Facts

- Endpoint: GET https://orcpin.dev/v1/batch-snapshot?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orcpin-batch-wallet-snapshot-d5c84c55
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_D6vgP5MceZ-ioqfSnaqug

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 orcpin-batch-wallet-snapshot-d5c84c55
```

Example prompt: Can you pull an on-chain wallet snapshot for these two Base addresses — 0xAbC...1234 and 0xDeF...5678 — and tell me their ETH and USDC balances as of the latest block?

## When to prefer this

Use this endpoint when you need a factual, block-anchored balance snapshot for multiple EVM addresses on Base in a single call. It is ideal for portfolio checks, on-chain analytics, DeFi monitoring, or any agent task that needs authoritative native and token balance data without relying on off-chain indexers. Prefer this over single-address lookups when querying 2+ wallets to save latency and cost.

## Known failure modes

- Invalid or malformed EVM address in the comma-separated list returns an error
- Exceeding the server-side max batch size returns a rejection
- Network or RPC unavailability on Base may cause a 503 or timeout
- Missing required 'addresses' query parameter returns a 400 validation error
- Payment not completed via x402 protocol returns a 402 Payment Required response

## How this service works

Batch wallet snapshots for multiple Base addresses in one paid call, all anchored to a single block: native and ERC-20 balances, account flags, and derived metrics per address. Efficient multi-wallet portfolio and balances lookup for AI agents. Billed per address, with volume discounts at 10+/50+/100+ addresses.

## Output

Returns a JSON object with a block-anchored snapshot for each requested address, including: native ETH balance (formatted and in wei), ERC-20 token balances (symbol, contract, decimals, formatted), account metadata (is_contract flag, transaction count), plus top-level fields for chain ID, block number, timestamp, data sources, and a schema version.

## 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": [
      "addresses"
     ],
     "properties": {
      "addresses": {
       "type": "string",
       "description": "Comma-separated EVM addresses (0x...). Max per batch is configured server-side."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "integer"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "sources": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "disclaimer": {
       "type": "string"
      },
      "block_number": {
       "type": "integer"
      },
      "schema_version": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "block",
  "chain": "Base",
  "count": 2,
  "results": [
   {
    "data": {
     "account": {
      "is_contract": false,
      "transaction_count": 42
     },
     "native_balance": {
      "wei": "1000000000000000",
      "symbol": "ETH",
      "formatted": "0.001"
     },
     "token_balances": [
      {
       "raw": "1000000",
       "symbol": "USDC",
       "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "decimals": 6,
       "formatted": "1.0"
      }
     ]
    },
    "address": "0x0000000000000000000000000000000000000001"
   },
   {
    "data": {
     "account": {
      "is_contract": false,
      "transaction_count": 42
     },
     "native_balance": {
      "wei": "1000000000000000",
      "symbol": "ETH",
      "formatted": "0.001"
     },
     "token_balances": [
      {
       "raw": "1000000",
       "symbol": "USDC",
       "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "decimals": 6,
       "formatted": "1.0"
      }
     ]
    },
    "address": "0x0000000000000000000000000000000000000002"
   }
  ],
  "sources": [
   "public_rpc",
   "on_chain_read"
  ],
  "chain_id": 8453,
  "timestamp": "2026-06-18T12:00:00.000Z",
  "disclaimer": "Informational snapshot. See /terms.",
  "block_number": 12345678,
  "schema_version": "1.0.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orcpin-batch-wallet-snapshot-d5c84c55/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from orcpin.dev](https://www.zero.xyz/host/orcpin.dev/llms.txt)