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.

Preview JSON Discover JSON Wallets to try Examples JSON x402 discovery x402 alias OpenAPI Agent skill

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

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"

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

# Uses WALLETLENS_X402_PRIVATE_KEY or X402_TEST_PRIVATE_KEY for paid get_portfolio calls
npm run mcp

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.