Examples for agents.

Use these calls to discover WalletLens, inspect a cached live demo response for free, then make a paid x402 request when arbitrary wallet data is needed.

Agent discovery

curl https://walletlens.wallyweb.com/discover
curl "https://walletlens.wallyweb.com/wallets-to-try?format=json"
curl "https://walletlens.wallyweb.com/examples?format=json"

Free intent helpers

curl "https://walletlens.wallyweb.com/ask?q=analyze%20wallet%200x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea%20on%20base"
curl "https://walletlens.wallyweb.com/analyze?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base"

Free quote

curl "https://walletlens.wallyweb.com/quote?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base"

Free paid-response samples

curl https://walletlens.wallyweb.com/examples/wallet-report
curl https://walletlens.wallyweb.com/examples/tx-history
curl https://walletlens.wallyweb.com/examples/portfolio

Free cached live preview

curl https://walletlens.wallyweb.com/preview
curl https://walletlens.wallyweb.com/preview/robinhood

x402 negotiation

curl -i "https://walletlens.wallyweb.com/portfolio?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chains=base,ethereum"

TxLens history negotiation

curl -i "https://walletlens.wallyweb.com/tx-history?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base&limit=20"

Wallet report negotiation

curl -i "https://walletlens.wallyweb.com/wallet-report?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base&limit=20"

Robinhood Stock Token report negotiation

curl -i "https://walletlens.wallyweb.com/wallet-report?address=0xfac1d7dC76bE90C5Cadd5B022af7838dd8190F16&chains=robinhood&limit=20"

Local paid test script

# Add a funded Base wallet private key to .env as X402_TEST_PRIVATE_KEY
npm run test:x402 -- --endpoint portfolio --address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chains base,ethereum
npm run test:x402 -- --endpoint tx-history --address 0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea --chains base --limit 20
npm run test:x402 -- --endpoint wallet-report --address 0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea --chains base --limit 20

MCP server

# Free tools work without a wallet. Paid tools use a dedicated agent wallet.
export WALLETLENS_X402_PRIVATE_KEY=0xYOUR_DEDICATED_AGENT_PRIVATE_KEY
export WALLETLENS_MAX_PAYMENT_USDC=0.02
export WALLETLENS_EXPECTED_PAY_TO=0xA7c82E9775A9594c673E3Fde8a42D3D17dE2B957
npx --yes @shawnwollenberg/walletlens-mcp@0.1.2

For custom clients, read /openapi.json, request /portfolio, /tx-history, or /wallet-report, satisfy the returned x402 payment requirement, and retry with the payment header.