# Orcpin Wallet Snapshot

> Orcpin 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-11).

Returns a block-anchored on-chain snapshot of an EVM wallet's balances and account metadata on Base, including native ETH and ERC-20 token holdings.

## Facts

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

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-wallet-snapshot-fcf83f9e
```

Example prompt: Can you pull a block-anchored snapshot of the wallet 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to see its ETH balance, any ERC-20 tokens it holds, and whether it's a contract?

## When to prefer this

Choose this endpoint when you need a factual, block-anchored on-chain read of a Base wallet's token and ETH balances — especially in agent workflows where auditability and block provenance matter. Prefer it over generic blockchain explorers when you need structured JSON output suitable for downstream computation, and when you need both native and ERC-20 balances in a single call on Base (chainId 8453).

## Known failure modes

- Invalid or malformed address (not a 0x-prefixed 40-hex-char string) returns a validation error
- Address not found or zero-activity wallet returns an empty balance snapshot
- Payment not received or x402 payment header missing/invalid results in 402 Payment Required
- RPC node unavailability or Base network congestion may cause timeout or stale data
- Chain reorganization may cause block number to be slightly behind tip

## How this service works

On-chain wallet snapshot on Base: native ETH and tracked ERC-20 token balances (USDC, WETH) plus account flags (contract status, transaction count) and derived metrics (wallet type, activity tier, gas runway), anchored to a specific block. Factual wallet balance and holdings lookup for AI agents — portfolio and on-chain data API.

## Output

A JSON object with the wallet's native ETH balance (in wei and formatted), an array of ERC-20 token balances (symbol, contract address, formatted amount), account metadata (is_contract flag, transaction count), the Base chain ID (8453), the specific block number the snapshot was taken at, a UTC timestamp, and a disclaimer. Data is sourced from public RPC and on-chain reads.

## 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": {
      "address": {
       "type": "string",
       "pattern": "^0x[a-fA-F0-9]{40}$",
       "description": "EVM wallet address to snapshot (0x...)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object"
      },
      "address": {
       "type": "string"
      },
      "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": {
  "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"
    }
   ]
  },
  "as_of": "block",
  "chain": "Base",
  "address": "0x0000000000000000000000000000000000000001",
  "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-wallet-snapshot-fcf83f9e/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)