# apiacre.com Base Account Snapshot

> apiacre.com Base Account Snapshot is a paid API for AI agents from apiacre.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a point-in-time snapshot of ETH balance, native USDC, up to four ERC-20 token balances, account nonce, and contract-code status for a given Base mainnet address at one resolved block.

## Facts

- Endpoint: POST https://apiacre.com/v1/crypto/base-account-snapshot
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apiacre-com-base-account-snapshot-043bc685
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wjPgiaTHFYaPslrfmqr3O

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 apiacre-com-base-account-snapshot-043bc685 -d '<json body>'
```

Example prompt: Pull a full account snapshot for Base mainnet address 0xAbC...123 — I need the ETH balance, native USDC, plus balances for these four ERC-20s: 0xToken1, 0xToken2, 0xToken3, 0xToken4 — and tell me if it's a contract or EOA, all pinned to the latest block.

## When to prefer this

Choose this endpoint when you need a comprehensive, atomic account snapshot on Base mainnet in a single call — combining ETH, USDC, multiple ERC-20 balances, nonce, and contract status — rather than making separate RPC calls for each. Ideal for agents that need to audit wallet state, validate pre-conditions before transactions, or build portfolio views without managing multiple JSON-RPC requests. Prefer this over raw eth_call when you need a unified, structured multi-token view without writing ABI call data manually.

## Known failure modes

- Invalid or malformed Ethereum address returns a 400 error
- Unsupported or future block tag returns an error indicating the block cannot be resolved
- More than four ERC-20 addresses supplied causes a validation error
- Invalid ERC-20 contract address (non-contract or wrong chain) may return zero balance or an error
- Network or RPC timeout causes a 503 or timeout error
- Non-Base mainnet addresses not supported — using Ethereum mainnet addresses will query the wrong chain

## How this service works

Read point-in-time ETH, native USDC, and up to four caller-selected ERC-20 balances plus account nonce and contract-code status at one resolved Base mainnet block.

## Output

Returns a structured JSON object containing the resolved block number and timestamp, ETH balance in wei, native USDC balance, up to four caller-specified ERC-20 balances with token metadata, the account transaction nonce, and a boolean or flag indicating whether the address holds contract bytecode (i.e., is a smart contract vs. an externally owned account).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string"
  },
  "block_tag": {
   "enum": [
    "latest",
    "safe",
    "finalized"
   ],
   "type": "string"
  },
  "token_contracts": {
   "type": "array",
   "items": {
    "type": "string"
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "block": {
    "hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
    "number": 34567890,
    "timestamp": "2026-08-10T16:00:00+00:00",
    "requestedTag": "safe"
   },
   "nonce": 0,
   "source": "https://docs.base.org/base-chain/quickstart/connecting-to-base",
   "tokens": [
    {
     "status": "ok",
     "symbol": "USDC",
     "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
     "decimals": 6,
     "standard": "ERC-20"
    }
   ],
   "address": "0x0000000000000000000000000000000000000000",
   "hasCode": false,
   "network": "eip155:8453",
   "balances": {
    "eth": {
     "wei": "0",
     "formatted": "0"
    },
    "usdc": {
     "atomic": "0",
     "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
     "decimals": 6,
     "formatted": "0"
    }
   },
   "disclaimer": "Point-in-time public Base chain state and caller-selected token contracts onl...",
   "usdcSource": "https://developers.circle.com/stablecoins/usdc-contract-addresses",
   "explorerUrl": "https://basescan.org/address/0x0000000000000000000000000000000000000000",
   "tokenSource": "https://eips.ethereum.org/EIPS/eip-20",
   "codeSizeBytes": 0,
   "requestedTokenCount": 1
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": [
    {
     "path": "/v1/crypto/base-usdc-transfers",
     "title": "Base USDC transfer history",
     "method": "POST",
     "reason": "Add recent official Base USDC transfer evidence to the point-in-time balance ...",
     "service": "crypto.base-usdc-transfers"
    }
   ]
  },
  "service": "crypto.base-account-snapshot",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apiacre-com-base-account-snapshot-043bc685/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)