Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol ecosystem for $0.01 per call.
What it does
This endpoint returns aggregate statistics for a specific wallet address within the x402 payment ecosystem. Given a wallet address, it reports metrics such as transaction count, total transfer amount, and unique recipients. The data covers x402 micropayment transfers on both Base and Solana chains, and can be filtered by chain and by a timeframe lookback of 1, 7, 14, or 30 days.
The endpoint is part of x402scan, an analytics dashboard and block explorer for the x402 protocol built by Merit Systems. x402scan indexes on-chain x402 micropayment activity and exposes it through a suite of paid data endpoints. This particular wallet stats endpoint costs $0.01 per request, paid via the x402 protocol (USDC micropayment). The broader x402scan API also offers endpoints for merchant stats, transaction histories, facilitator analytics, resource search, and a registry for x402-protected resources.
Note: During probing, this specific endpoint (with a hardcoded wallet address in the path) returned HTTP 404 rather than the expected 402 challenge. This may indicate the particular wallet address is not indexed, or the endpoint path uses a different URL pattern than the one registered. The OpenAPI spec defines the canonical path as `/api/x402/wallets/{address}/stats`, while the registered URL uses `/api/data/wallets/{address}/stats`. The endpoint may still be functional at the canonical OpenAPI path.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific x402 buyer wallet
- —Monitor a wallet's x402 spending activity over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption per wallet
- —Audit an agent's micropayment history and recipient diversity
Fit
Best for
- —Agents needing quick aggregate stats on x402 wallet activity
- —Analytics tools monitoring x402 protocol ecosystem health
- —Developers building on top of x402 who need wallet-level metrics
Not for
- —General-purpose blockchain explorers needing full transaction details beyond x402
- —Wallets or addresses that have never participated in x402 payments
- —Free/unauthenticated bulk data access — every call costs $0.01
Quick start
curl -H "X-Payment: <x402-payment-header>" \
"https://www.x402scan.com/api/x402/wallets/0x45417bb4ac783cbdfea61e19e52272a8e9b00e23/stats?chain=base&timeframe=30"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters, pricing, and operation descriptions. However, the probed endpoint URL (/api/data/wallets/...) returned 404 instead of 402, suggesting a URL mismatch between the registered endpoint and the canonical OpenAPI path (/api/x402/wallets/...). No response schema or example responses are provided. No dedicated docs page exists.
Warnings
- —Probed endpoint returned 404 on both GET and POST — the registered URL path (/api/data/wallets/) differs from the OpenAPI canonical path (/api/x402/wallets/). The endpoint may only be live at the canonical path.
- —No response schema is documented in the OpenAPI spec — response structure must be inferred.
- —No dedicated documentation pages found (/docs, /api, /pricing all return 404).
Citations
- —Endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —Supports chain filter (base, solana) and timeframe filter (1, 7, 14, or 30 days)https://www.x402scan.com
- —x402scan is described as 'the x402 analytics dashboard and block explorer'https://www.x402scan.com
- —Built by Merit Systemshttps://www.x402scan.com
- —OpenAPI spec defines the wallet stats endpoint at /api/x402/wallets/{address}/statshttps://www.x402scan.com