{"uid":"cap_wjPgiaTHFYaPslrfmqr3O","slug":"apiacre-com-base-account-snapshot-043bc685","name":"apiacre.com Base Account Snapshot","description":"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.","url":"https://apiacre.com/v1/crypto/base-account-snapshot","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string"},"block_tag":{"enum":["latest","safe","finalized"],"type":"string"},"token_contracts":{"type":"array","items":{"type":"string"}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FhbQsYPwaV2J5tpUzq2eP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"DeFi portfolio balance audit","prompt":"Grab a point-in-time snapshot for my Base wallet 0xAbC...123 at the latest block — I want ETH, native USDC, and balances for USDC bridged (0xA0b86991...), DAI (0x50c5725...), WETH (0x4200000...), and cbETH (0xBe9895...), plus my nonce and whether the address is a contract."},{"title":"Pre-transaction nonce and balance check","prompt":"Before I submit a transaction from 0xDef...456 on Base, check the current ETH balance and nonce at the latest block so I can confirm I have enough gas and the right sequence number."},{"title":"Historical block state verification","prompt":"I need to verify the exact token balances held by address 0x789...ABC on Base mainnet at block 12345678 — include ETH, native USDC, and the ERC-20s at 0xToken1 and 0xToken2, and tell me if that address was a contract at that block."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:32:03.800Z","isFirstParty":false}