Skip to content
crypto · crypto · evm · wallet-balance · token-balance · erc20-balance · balanceof · base · ethereum · wallet · address · balance · usdc · erc20 · token · holdings · portfolio · nonce · contract · onchain

Base account snapshot

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.

$0.01 USDCBase + Solanax402 v2POST
Pay $0.01 USDC and run in your browserView free result sample

Endpoint

https://apiacre.com/v1/crypto/base-account-snapshot

Send the JSON body below. An unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header; an x402-compatible buyer signs the requirement and retries with PAYMENT-SIGNATURE.

Pay $0.01 USDC and run in your browser

Official Coinbase agent path

Coinbase Agentic Wallet can satisfy this x402 request in one command. Running it may pay automatically, so --max-amount is fixed to $0.01 USDC in atomic units. Copying the command does not install, authenticate, sign, or pay; review the request and use a separate low-value wallet before running it.

npx --yes awal@latest x402 pay https://apiacre.com/v1/crypto/base-account-snapshot \
  -X POST \
  -d '{"address":"0x0000000000000000000000000000000000000000","block_tag":"safe","token_contracts":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}' \
  --max-amount 10000 \
  --json

Coinbase pay-for-service documentation · Buyer setup and wallet safety

Alternative third-party AgentCash commands

Run check first without payment. Its fetch command may automatically pay up to the exact listed price.

npx --yes agentcash@latest check https://apiacre.com/v1/crypto/base-account-snapshot
npx --yes agentcash@latest fetch https://apiacre.com/v1/crypto/base-account-snapshot \
  --method POST \
  --header 'content-type: application/json' \
  --body '{"address":"0x0000000000000000000000000000000000000000","block_tag":"safe","token_contracts":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}' \
  --payment-protocol x402 \
  --payment-network base \
  --max-amount 0.010

AgentCash CLI documentation

Input example

{
  "address": "0x0000000000000000000000000000000000000000",
  "block_tag": "safe",
  "token_contracts": [
    "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
  ]
}

Response shape

View free static sample JSON

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-account-snapshot",
  "version": "1",
  "data": {
    "network": "eip155:8453",
    "address": "0x0000000000000000000000000000000000000000",
    "block": {
      "requestedTag": "safe",
      "number": 34567890,
      "hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
      "timestamp": "2026-08-10T16:00:00+00:00"
    },
    "balances": {
      "eth": {
        "wei": "0",
        "formatted": "0"
      },
      "usdc": {
        "atomic": "0",
        "formatted": "0",
        "decimals": 6,
        "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
      }
    },
    "requestedTokenCount": 1,
    "tokens": [
      {
        "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "standard": "ERC-20",
        "status": "ok",
        "symbol": "USDC",
        "decimals": 6,
        "balanceAtomic": "0",
        "balanceFormatted": "0",
        "warnings": []
      }
    ],
    "nonce": 0,
    "hasCode": false,
    "codeSizeBytes": 0,
    "explorerUrl": "https://basescan.org/address/0x0000000000000000000000000000000000000000",
    "source": "https://docs.base.org/base-chain/quickstart/connecting-to-base",
    "usdcSource": "https://developers.circle.com/stablecoins/usdc-contract-addresses",
    "tokenSource": "https://eips.ethereum.org/EIPS/eip-20",
    "disclaimer": "Point-in-time public Base chain state and caller-selected token contracts only. Token metadata is untrusted and optional; no ownership, identity, risk, solvency, portfolio-completeness, or transaction-intent conclusion is provided."
  },
  "meta": {
    "duration_ms": 42,
    "cached": false,
    "sources": [],
    "warnings": [],
    "next_actions": [
      {
        "service": "crypto.base-usdc-transfers",
        "title": "Base USDC transfer history",
        "reason": "Add recent official Base USDC transfer evidence to the point-in-time balance snapshot.",
        "method": "POST",
        "path": "/v1/crypto/base-usdc-transfers",
        "price": "$0.005",
        "input_template": {
          "address": "$request.address",
          "lookback_blocks": 2000,
          "direction": "any",
          "limit": 25,
          "block_tag": "$request.block_tag"
        },
        "use_output": "Compare bounded events with the snapshot only as point-in-time evidence; neither result is complete transaction history or identity proof.",
        "handoff_path": "/catalog/crypto.base-usdc-transfers",
        "checkout_path": "/try/crypto.base-usdc-transfers",
        "sample_path": "/samples/crypto.base-usdc-transfers",
        "maximum_atomic_usdc": "5000",
        "handoff_payment_required": false,
        "executes_automatically": false,
        "authorization_required": true
      }
    ]
  }
}

Continue this workflow

These optional follow-ups use this result in a larger workflow. Each call shows a fresh x402 challenge and requires separate buyer authorization.

Try the payment challenge

curl -i -X POST 'https://apiacre.com/v1/crypto/base-account-snapshot' \
  -H 'content-type: application/json' \
  --data '{"address":"0x0000000000000000000000000000000000000000","block_tag":"safe","token_contracts":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}'