Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol explorer.
What it does
This endpoint returns aggregate statistics for a specific wallet address within the x402 payment ecosystem. It is part of x402scan, a payment data explorer and analytics dashboard for the x402 protocol built by Merit Systems. The wallet stats endpoint provides metrics such as transaction count, total volume, and unique recipients for any wallet that has sent x402 transfers.
The endpoint accepts optional query parameters to filter by chain (Base or Solana) and timeframe (1, 7, 14, or 30 days lookback). It is priced at $0.01 per call, payable via x402 micropayment using the X-Payment header. The broader x402scan platform indexes x402 payment activity across Base and Solana chains and tracks merchants, buyers, facilitators, and registered resources.
Note: The probe returned 404 for this specific URL path (`/api/data/wallets/{address}/stats`), while the OpenAPI spec documents the endpoint at `/api/x402/wallets/{address}/stats`. The listed endpoint URL appears to use a legacy or incorrect path prefix (`/api/data/` instead of `/api/x402/`). The canonical working path is likely `https://www.x402scan.com/api/x402/wallets/{address}/stats`.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address across x402 transactions
- —Monitor wallet activity over configurable timeframes (1, 7, 14, or 30 days)
- —Filter wallet stats by chain (Base or Solana) to analyze cross-chain payment behavior
- —Build dashboards tracking x402 protocol adoption and wallet-level metrics
- —Audit a wallet's x402 spending history programmatically
Fit
Best for
- —Agents needing on-chain x402 payment analytics per wallet
- —Developers building x402 ecosystem monitoring tools
- —Analysts tracking USDC micropayment flows on Base and Solana
Not for
- —General-purpose blockchain explorers (this only covers x402 protocol transfers)
- —Wallets or addresses not participating in the x402 ecosystem
- —Real-time streaming transaction feeds (this returns aggregate snapshots)
Quick start
curl -H "X-Payment: <x402-payment-token>" \
"https://www.x402scan.com/api/x402/wallets/0xae39563679f34561e54ba53a97ecfd69c0ba334a/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is thorough and pricing is clear ($0.01/call), but the actual listed endpoint URL (/api/data/...) returned 404 on probe — the working path appears to be /api/x402/... per the spec. No response schema or example responses are documented. No dedicated docs page exists.
Warnings
- —The listed endpoint path /api/data/wallets/{address}/stats returned 404; the OpenAPI spec documents the endpoint at /api/x402/wallets/{address}/stats — the URL may be incorrect.
- —No response schema is documented in the OpenAPI spec; response structure must be inferred.
- —No dedicated documentation pages were found (/docs, /api, /pricing all return 404).
Citations
- —The endpoint is priced at $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —The OpenAPI spec documents the wallet stats endpoint at /api/x402/wallets/{address}/stats with chain and timeframe parametershttps://www.x402scan.com
- —Supported chains are Base and Solana; timeframe options are 1, 7, 14, or 30 dayshttps://www.x402scan.com