Live on Base · x402

Normalized EVM wallet data,
priced per request.

WalletLens is a paid HTTP API for agents. Pass an address, get a wallet report, portfolio balances, Base USDC transfer history, or enriched transaction history across major EVM chains — settled in USDC over x402 for $0.02 a call.

# Discover the paid resource
curl https://walletlens.wallyweb.com/.well-known/x402.json

# Start from seeded wallet URLs
curl "https://walletlens.wallyweb.com/wallets-to-try?format=json"
curl "https://walletlens.wallyweb.com/ask?q=analyze%20wallet%200x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea%20on%20base"

# Call a paid endpoint with an x402 client
curl "https://walletlens.wallyweb.com/portfolio?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chains=base,ethereum"
curl "https://walletlens.wallyweb.com/tx-history?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base&limit=20"
curl "https://walletlens.wallyweb.com/wallet-report?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base&limit=20"

# Returns 402 Payment Required without a payment header.
# Pay $0.02 USDC on Base, retry with the x402 payment header,
# and receive a normalized JSON snapshot.

Endpoints

GET
/portfolio
Normalized snapshot — tokens, prices, native balance, recent activity.
$0.02 USDC
GET
/tx-history
TxLens enriched transfer history with direction, categories, labels, and insights.
$0.02 USDC
GET
/wallet-report
Bundled wallet report with portfolio, top holdings, transaction history, and activity summary.
$0.02 USDC
GET
/wallets-to-try
Seed wallet addresses with free intent-helper links and direct paid report URLs.
free
GET
/ask
Convert natural-language wallet intent into a quote URL and paid WalletLens URL.
free
GET
/analyze
Structured helper for agents that already have an EVM address.
free
GET
/preview
Free cached live demo wallet response for agents evaluating WalletLens.
free
GET
/.well-known/x402.json
x402 discovery document for paid resources.
free
GET
/openapi.json
Machine-readable API schema.
free
GET
/health
Liveness and configuration check.
free

Supported chains

base ethereum optimism arbitrum polygon

Built for agents

x402 native

HTTP 402 Payment Required with USDC settlement on Base. No accounts, no API keys.

Normalized output

Consistent portfolio and transaction schemas across every supported chain.

MCP server included

Local stdio MCP server exposes wallet portfolio and transaction history tools to agent clients.

Powered by Alchemy

Portfolio data sourced from Alchemy's multi-chain APIs and returned in one snapshot.