crypto · crypto · evm · base · ethereum · rpc · wallet · address · account · eth · balance · nonce · bytecode · contract · onchain · read-only

Base account status

Read ETH balance, transaction nonce, and contract-code evidence for one address at a single resolved Base mainnet block.

$0.003 USDCBasex402 v2POST

Endpoint

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

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.003 USDC and run in your browser

Agent one-call path

Optional third-party AgentCash can inspect this route and handle the x402 retry. This example does not pass its payment auto-confirm flag and caps the call at exactly $0.003 USDC. Review the local wallet and request before approving payment.

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

AgentCash CLI documentation · Official SDK and wallet-safety alternatives

Input example

{
  "address": "0x0000000000000000000000000000000000000000",
  "block_tag": "safe"
}

Response shape

View free static sample JSON

{
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a",
  "service": "crypto.base-account-status",
  "version": "1",
  "data": {
    "network": "eip155:8453",
    "address": "0x0000000000000000000000000000000000000000",
    "block": {
      "requestedTag": "safe",
      "number": 34567890,
      "hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
      "timestamp": "2026-08-10T16:00:00+00:00"
    },
    "ethBalance": {
      "wei": "0",
      "formatted": "0"
    },
    "nonce": 0,
    "code": {
      "status": "absent",
      "sizeBytes": 0,
      "sha256": null
    },
    "networkRequestsMade": 2,
    "readOnly": true,
    "transactionBroadcast": false,
    "warnings": [],
    "explorerUrl": "https://basescan.org/address/0x0000000000000000000000000000000000000000",
    "source": "https://docs.base.org/base-chain/quickstart/connecting-to-base",
    "disclaimer": "Point-in-time public Base state only. Empty code does not prove that an address is controlled, safe, active, or permanently an externally owned account; no identity, ownership, token portfolio, solvency, or transaction-intent conclusion is provided."
  },
  "meta": {
    "duration_ms": 42,
    "cached": false,
    "sources": [],
    "warnings": [],
    "next_actions": [
      {
        "service": "crypto.base-account-snapshot",
        "title": "Base account snapshot",
        "reason": "Expand the account status into one-block ETH, native USDC, and optional caller-selected ERC-20 balances.",
        "method": "POST",
        "path": "/v1/crypto/base-account-snapshot",
        "price": "$0.01",
        "input_template": {
          "address": "$request.address",
          "block_tag": "safe",
          "token_contracts": []
        },
        "use_output": "Use the richer result when the buyer needs explicitly scoped Base token balances as well as account status.",
        "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-status' \
  -H 'content-type: application/json' \
  --data '{"address":"0x0000000000000000000000000000000000000000","block_tag":"safe"}'