x402AgentTools

🔎Wallet Snapshot (Live)

One-call on-chain profile of any Ethereum or Base wallet via Blockscout: native balance, transaction and transfer counts, activity recency, top token holdings, and most frequent recent counterparties — with fresh-wallet and high-volume flags. The 'who is this address?' conclusion, not raw RPC data.

Worked examples

vitalik.eth on Ethereum

GET /api/v1/crypto/wallet-snapshot?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=ethereum

Result: 5.77 ETH · 78.37K txs

Coinbase 1 hot wallet

GET /api/v1/crypto/wallet-snapshot?address=0x71660c4005BA85c37ccec55d0C4493E66Fe775d3&chain=ethereum

Result: 11.08 ETH · 0 txs

Machine API (x402)

$0.010 / call

This tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol — no accounts, no API keys.

GET /api/v1/crypto/wallet-snapshot?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chain=ethereum HTTP/1.1
Host: localhost:3000

→ 402 (payment required, instructions in headers)
→ 200 (after X-PAYMENT header; JSON body below)

{
  "tool": "crypto/wallet-snapshot",
  "input": {"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chain":"ethereum"},
  "result": { "value": 5.769553936881799, "answer": "5.77 ETH · 78.37K txs" }
}

Agent docs: /llms.txt · OpenAPI spec · integration guide

About this tool

The 'who is this address?' conclusion in one call: native balance, lifetime transaction and transfer counts, last activity, top token holdings, and the counterparties a wallet actually interacts with — plus instant flags for fresh wallets, contracts and dormant accounts. Sourced live from Blockscout, no API key.

Frequently asked questions

Why a snapshot instead of raw transaction data?

Raw RPC gives you 10,000 transactions; an agent needs the five signals that describe a wallet. This tool computes the conclusions — counts, counterparties, flags — so the agent spends tokens on decisions, not parsing.

Does it track profit and loss?

Not yet. P&L requires historical prices per acquisition — planned as a premium deep-analysis tier (Phase 4).

Related tools