Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol ecosystem.
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 amount sent, and unique recipients for a given sender wallet. It supports optional query parameters to filter by chain (base or solana) and timeframe (1, 7, 14, or 30 days lookback). The endpoint costs $0.01 per call, paid via an x402 micropayment using the X-Payment header.
Note: The specific URL listed here hard-codes a particular wallet address (`0x987a3f69062583fb9da04684420728fbe72b4513`) in the path. The probe returned 404 rather than the expected 402 challenge, which may indicate this particular address is not indexed, or the URL path uses a slightly different routing scheme (`/api/data/wallets/` vs the documented `/api/x402/wallets/`). The OpenAPI spec documents the canonical path as `/api/x402/wallets/{address}/stats`. The broader x402scan API platform is live (root returns 200) and the OpenAPI spec is well-documented with 13+ endpoints covering wallets, merchants, facilitators, resources, registry, and USDC send functionality.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific x402 sender wallet
- —Monitor wallet activity across Base and Solana chains over configurable timeframes
- —Build dashboards tracking x402 protocol adoption and wallet-level metrics
- —Audit a wallet's x402 spending history programmatically
- —Compare wallet activity across different time windows (1d, 7d, 14d, 30d)
Fit
Best for
- —Agents needing on-chain x402 payment analytics per wallet
- —Developers building x402 ecosystem monitoring tools
- —Researchers analyzing x402 protocol adoption and usage patterns
Not for
- —General-purpose blockchain explorers (only covers x402 protocol transfers)
- —Real-time streaming transaction feeds (this is an aggregate stats endpoint)
- —Non-USDC token analytics
Quick start
curl -H "X-Payment: <x402-payment-token>" \
"https://www.x402scan.com/api/x402/wallets/0x987a3f69062583fb9da04684420728fbe72b4513/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is thorough with clear parameter definitions and pricing, but the specific probed endpoint returned 404 (possibly due to a path mismatch: /api/data/ vs /api/x402/). No response schema or example responses are documented. No dedicated docs page exists.
Warnings
- —Probed URL uses /api/data/wallets/ but OpenAPI spec documents /api/x402/wallets/ — the listed endpoint path may be incorrect or deprecated
- —Probe returned 404 on both GET and POST, so this specific URL could not be confirmed live
- —No response schema is provided in the OpenAPI spec — response structure must be inferred
- —No dedicated documentation page found (docs, pricing, README all return 404)
Citations
- —The endpoint costs $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
- —Wallet stats endpoint supports chain (base, solana) and timeframe (1, 7, 14, 30) query parametershttps://www.x402scan.com
- —The canonical path is /api/x402/wallets/{address}/stats per the OpenAPI spechttps://www.x402scan.com
- —x402scan indexes transfers on Base and Solana chainshttps://www.x402scan.com