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 built by Merit Systems that indexes x402 protocol transfers on Base and Solana chains.
The wallet stats endpoint (`GET /api/x402/wallets/{address}/stats`) provides summary metrics such as transaction count, total transfer amount, and unique recipients for a given sender address. Results can be filtered by chain (Base or Solana) and by timeframe (1, 7, 14, or 30 days lookback). The endpoint is priced at $0.01 per call, paid via the x402 micropayment protocol.
Note: The specific URL listed here hard-codes a particular wallet address (`0x1aeaa0746332074ebbf751cf9aa7ae4813731ea4`) in the path. The probe returned 404 rather than the expected 402 challenge, which may indicate this particular address has no indexed data or the URL path format differs from the OpenAPI spec (which uses `/api/x402/wallets/{address}/stats` rather than `/api/data/wallets/{address}/stats`). The OpenAPI spec documents the canonical path as `/api/x402/wallets/{address}/stats`. x402scan also offers related endpoints for merchant stats, transaction history, facilitator analytics, resource search, and USDC transfers.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a wallet that has sent x402 transfers
- —Monitor transaction volume and unique recipient counts for a specific sender address over configurable time windows
- —Build dashboards tracking x402 protocol adoption by querying wallet-level metrics
- —Filter wallet activity by chain (Base vs Solana) for cross-chain analytics
Fit
Best for
- —Agents needing on-chain x402 payment analytics per wallet
- —Developers building x402 ecosystem monitoring tools
- —Analysts tracking micropayment adoption across Base and Solana
Not for
- —General-purpose blockchain explorers (only covers x402 protocol transfers)
- —Querying non-USDC token transfers or arbitrary on-chain data
- —Real-time streaming of transactions (this returns aggregate snapshots)
Quick start
curl -H "X-Payment: <x402_payment_token>" \
"https://www.x402scan.com/api/x402/wallets/0x1aeaa0746332074ebbf751cf9aa7ae4813731ea4/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters and pricing, but the probed endpoint returned 404 (not the expected 402 challenge), and the listed URL path (/api/data/wallets/...) differs from the OpenAPI canonical path (/api/x402/wallets/...). No response schema or example responses are available.
Warnings
- —Probe returned 404 on both GET and POST — the endpoint URL uses '/api/data/wallets/' but the OpenAPI spec documents '/api/x402/wallets/'. The listed URL may be incorrect.
- —No response schema or example responses are documented in the OpenAPI spec.
- —No dedicated docs page found (x402scan.com/docs returns 404).
Citations
- —The wallet stats endpoint is priced at $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —x402scan is described as a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —The OpenAPI spec documents the canonical path as /api/x402/wallets/{address}/stats with chain and timeframe query parametershttps://www.x402scan.com
- —Supports filtering by Base and Solana chains with timeframe lookback of 1, 7, 14, or 30 dayshttps://www.x402scan.com