Back to Browse
Base Wallet Snapshot
x402
Base Wallet Snapshot is a paid API for AI agents from api.zfinia.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-10).
Reads a Base wallet's native ETH balance and up to five ERC20 token balances atomically at the same pinned block height in a single call.
Price / call$0.008
Success—
StatusUnknown
How this service works
Read a Base wallet native ETH balance and up to five ERC20 token balances at one pinned block. Separate balance lookups each answer at whatever height they happened to see, so they cannot be compared; these are all read at the same block and the block is in the response. Replaces six calls with one.
Output
Returns the wallet's native ETH balance, the balance of each requested ERC20 token (up to five), and the pinned block number at which all balances were read — enabling consistent cross-asset comparison in a single response.
Example use cases
DeFi portfolio snapshot for accounting
“Pull the ETH balance plus USDC (0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA) and DAI (0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb) balances for wallet 0xAbCd1234abcd1234abcd1234abcd1234abcd1234 on Base — I need all three pinned to the same block so I can run accurate P&L calculations.”
Agent treasury health check
“Check the ETH and token balances for our treasury wallet 0xDead0000beef0000cafe0000dead0000beef0000 on Base — include USDC at 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA and cbETH at 0xBe9895146f7AF43049ca1c1AE358B0541Ea49704 all at the same block height so the numbers are consistent.”
Pre-trade liquidity check
“Before I execute a swap, can you snapshot wallet 0x1234abcd1234abcd1234abcd1234abcd1234abcd on Base and tell me its ETH balance alongside its WETH (0x4200000000000000000000000000000000000006) and USDC (0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA) balances, all at the same block?”
Technical details
Endpoint
POSThttps://api.zfinia.com/x402/v1/base-wallet-snapshot?utm_source=zero.xyzWhen to prefer
Choose this endpoint when you need ETH and multiple ERC20 token balances for a single Base wallet at a consistent block height — replacing up to six separate RPC calls with one atomic snapshot. Ideal for DeFi agents, portfolio trackers, treasury monitors, and any workflow where cross-asset balance comparisons must be temporally consistent. Prefer this over individual balance lookups whenever block-height consistency matters.
Side effects
- Invalid wallet address format (not a valid 0x hex address) returns a validation error
- ERC20 contract address that is not a valid token contract may return zero or an error
- More than five ERC20 addresses in the tokens array is rejected
- Network or RPC unavailability on Base may result in a timeout or 5xx error
- Payment failure via x402 protocol results in 402 response before data is returned
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| tokens | array | Up to five ERC20 contract addresses to read balances for. |
| wallet | string | Wallet address to read. |
Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"