{"service":"WalletLens","baseUrl":"https://walletlens.wallyweb.com","description":"Copy-paste examples for discovering WalletLens and making x402-paid EVM wallet intelligence calls.","demoWallet":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","free":[{"name":"Browse seeded wallets with direct paid URLs","method":"GET","url":"https://walletlens.wallyweb.com/wallets-to-try","curl":"curl \"https://walletlens.wallyweb.com/wallets-to-try?format=json\""},{"name":"Convert natural-language wallet intent into a paid URL","method":"GET","url":"https://walletlens.wallyweb.com/ask?q=analyze%20wallet%200x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea%20on%20base","curl":"curl \"https://walletlens.wallyweb.com/ask?q=analyze%20wallet%200x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea%20on%20base\""},{"name":"Analyze intent with structured query params","method":"GET","url":"https://walletlens.wallyweb.com/analyze?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base","curl":"curl \"https://walletlens.wallyweb.com/analyze?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base\""},{"name":"Discover WalletLens capabilities","method":"GET","url":"https://walletlens.wallyweb.com/discover","curl":"curl https://walletlens.wallyweb.com/discover"},{"name":"Get a quote before paying","method":"GET","url":"https://walletlens.wallyweb.com/quote?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base","curl":"curl \"https://walletlens.wallyweb.com/quote?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base\""},{"name":"Read x402 discovery metadata","method":"GET","url":"https://walletlens.wallyweb.com/.well-known/x402.json","curl":"curl https://walletlens.wallyweb.com/.well-known/x402.json"},{"name":"Inspect a free cached preview response","method":"GET","url":"https://walletlens.wallyweb.com/preview","curl":"curl https://walletlens.wallyweb.com/preview"},{"name":"Inspect sample wallet report JSON without payment","method":"GET","url":"https://walletlens.wallyweb.com/examples/wallet-report","curl":"curl https://walletlens.wallyweb.com/examples/wallet-report"}],"paidNegotiation":[{"intent":"Get one bundled wallet report with portfolio and transaction history","method":"GET","path":"/wallet-report","url":"https://walletlens.wallyweb.com/wallet-report?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base&limit=20","curl":"curl -i \"https://walletlens.wallyweb.com/wallet-report?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base&limit=20\"","expectedUnpaidStatus":402},{"intent":"Get enriched transaction history only","method":"GET","path":"/tx-history","url":"https://walletlens.wallyweb.com/tx-history?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base&limit=20","curl":"curl -i \"https://walletlens.wallyweb.com/tx-history?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base&limit=20\"","expectedUnpaidStatus":402},{"intent":"Get normalized portfolio balances only","method":"GET","path":"/portfolio","url":"https://walletlens.wallyweb.com/portfolio?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chains=base,ethereum","curl":"curl -i \"https://walletlens.wallyweb.com/portfolio?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chains=base,ethereum\"","expectedUnpaidStatus":402}],"walletsToTry":[{"label":"Base USDC demo wallet","address":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","chains":"base","prompt":"analyze this Base wallet and summarize holdings plus recent USDC transfers","askUrl":"https://walletlens.wallyweb.com/ask?q=analyze%20this%20Base%20wallet%20and%20summarize%20holdings%20plus%20recent%20USDC%20transfers%3A%200x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea%20on%20base","analyzeUrl":"https://walletlens.wallyweb.com/analyze?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base","quoteUrl":"https://walletlens.wallyweb.com/quote?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base","paidWalletReportUrl":"https://walletlens.wallyweb.com/wallet-report?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base&limit=20","paidTxHistoryUrl":"https://walletlens.wallyweb.com/tx-history?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base&limit=20","paidPortfolioUrl":"https://walletlens.wallyweb.com/portfolio?address=0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea&chains=base"},{"label":"Public Ethereum wallet example","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chains":"base,ethereum","prompt":"analyze this public Ethereum wallet and summarize portfolio plus recent activity","askUrl":"https://walletlens.wallyweb.com/ask?q=analyze%20this%20public%20Ethereum%20wallet%20and%20summarize%20portfolio%20plus%20recent%20activity%3A%200xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045%20on%20base%2Cethereum","analyzeUrl":"https://walletlens.wallyweb.com/analyze?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chains=base%2Cethereum","quoteUrl":"https://walletlens.wallyweb.com/quote?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chains=base%2Cethereum","paidWalletReportUrl":"https://walletlens.wallyweb.com/wallet-report?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chains=base%2Cethereum&limit=20","paidTxHistoryUrl":"https://walletlens.wallyweb.com/tx-history?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chains=base%2Cethereum&limit=20","paidPortfolioUrl":"https://walletlens.wallyweb.com/portfolio?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&chains=base%2Cethereum"},{"label":"Ethereum burn address","address":"0x000000000000000000000000000000000000dEaD","chains":"ethereum,base","prompt":"summarize token holdings and transfers for the Ethereum burn address","askUrl":"https://walletlens.wallyweb.com/ask?q=summarize%20token%20holdings%20and%20transfers%20for%20the%20Ethereum%20burn%20address%3A%200x000000000000000000000000000000000000dEaD%20on%20ethereum%2Cbase","analyzeUrl":"https://walletlens.wallyweb.com/analyze?address=0x000000000000000000000000000000000000dEaD&chains=ethereum%2Cbase","quoteUrl":"https://walletlens.wallyweb.com/quote?address=0x000000000000000000000000000000000000dEaD&chains=ethereum%2Cbase","paidWalletReportUrl":"https://walletlens.wallyweb.com/wallet-report?address=0x000000000000000000000000000000000000dEaD&chains=ethereum%2Cbase&limit=20","paidTxHistoryUrl":"https://walletlens.wallyweb.com/tx-history?address=0x000000000000000000000000000000000000dEaD&chains=ethereum%2Cbase&limit=20","paidPortfolioUrl":"https://walletlens.wallyweb.com/portfolio?address=0x000000000000000000000000000000000000dEaD&chains=ethereum%2Cbase"},{"label":"Ethereum zero address","address":"0x0000000000000000000000000000000000000000","chains":"ethereum,base","prompt":"inspect token balances and transfer history for the zero address","askUrl":"https://walletlens.wallyweb.com/ask?q=inspect%20token%20balances%20and%20transfer%20history%20for%20the%20zero%20address%3A%200x0000000000000000000000000000000000000000%20on%20ethereum%2Cbase","analyzeUrl":"https://walletlens.wallyweb.com/analyze?address=0x0000000000000000000000000000000000000000&chains=ethereum%2Cbase","quoteUrl":"https://walletlens.wallyweb.com/quote?address=0x0000000000000000000000000000000000000000&chains=ethereum%2Cbase","paidWalletReportUrl":"https://walletlens.wallyweb.com/wallet-report?address=0x0000000000000000000000000000000000000000&chains=ethereum%2Cbase&limit=20","paidTxHistoryUrl":"https://walletlens.wallyweb.com/tx-history?address=0x0000000000000000000000000000000000000000&chains=ethereum%2Cbase&limit=20","paidPortfolioUrl":"https://walletlens.wallyweb.com/portfolio?address=0x0000000000000000000000000000000000000000&chains=ethereum%2Cbase"}],"localPaidTest":["Add a funded Base wallet private key to .env as X402_TEST_PRIVATE_KEY.","Run: npm run test:x402 -- --endpoint wallet-report --address 0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea --chains base --limit 20"],"notes":["Missing or invalid address returns HTTP 400 before payment negotiation.","A valid unpaid paid-endpoint request returns HTTP 402 with a payment-required header.","After creating the x402 payment payload, retry the exact same URL with the payment header."]}