{"uid":"cap_9X2vypl_vJSjoHa-DGjR_","slug":"x402scan-wallet-aggregate-stats-c910bed4","name":"x402scan Wallet Aggregate Stats","description":"Aggregate stats for a wallet (tx count, total amount, unique recipients)","url":"https://x402scan-git-router-117-merit-systems.vercel.app/api/x402/wallets/:address/stats","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"chain":{"enum":["base","solana"],"type":"string","description":"Filter by chain"},"timeframe":{"anyOf":[{"type":"number","const":1},{"type":"number","const":7},{"type":"number","const":14},{"type":"number","const":30}],"description":"Days lookback (1, 7, 14, or 30)"}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DASwgxIjVFzMZeu7O0L7r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregate transaction statistics (tx count, total amount, unique recipients) for a given wallet address on the x402 payment network","exampleAgentPrompt":"Can you pull the 30-day x402 payment stats for wallet 0xAbC123... on base — I want to see how many transactions they've made, the total amount sent, and how many unique recipients they've reached?","exampleUseCases":[{"title":"Monitor high-value wallet activity","prompt":"Check the x402 payment stats for 0x7d8F3c... on Solana over the last week. I need to know their transaction count, total amount they've moved, and how many different recipients they've sent to."},{"title":"Verify customer payment engagement","prompt":"Pull the 14-day x402 stats for wallet 0x2e9Bb4... on base chain. I want to understand their payment volume and whether they're actively reaching new recipients or just consolidating funds."},{"title":"Analyze wallet ecosystem participation","prompt":"Show me the 30-day x402 aggregate stats for 0xF1a45d... including their total transaction count, cumulative send amount, and unique recipient diversity. I'm trying to gauge how connected this wallet is to the x402 network."}],"resultDescription":"Returns aggregate statistics for the specified wallet address including total transaction count, cumulative payment amount, and number of unique recipients, optionally filtered by chain (base or solana) and timeframe (1, 7, 14, or 30 days).","failureModes":["Invalid wallet address format — returns 400 or empty result","Unsupported chain value — only 'base' or 'solana' accepted","Invalid timeframe value — only 1, 7, 14, or 30 days allowed","Wallet not found or no transaction history — returns zero stats or 404","Payment failure — $0.01 USDC not available or x402 payment rejected"],"whenToPreferThis":"Use this endpoint when you need a concise statistical summary of a wallet's outbound payment activity on the x402 network, specifically tx count, volume, and unique recipient diversity. Prefer this over raw transaction list endpoints when you want aggregated metrics rather than individual tx details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:25.088Z","isFirstParty":false}