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. Given a wallet address, it reports metrics such as transaction count, total transfer volume, 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 across facilitators like Coinbase, PayAI, and Meridian. The wallet stats endpoint costs $0.01 per call, paid via the x402 micropayment protocol (USDC). The specific address in the URL (0x0412ab03b5f9e7ed96b0419c4c8bdd63220d4e0f) is hardcoded in this listing, but the same pattern applies to any wallet address via `/api/x402/wallets/{address}/stats`.
Note: during probing, this specific endpoint returned 404 rather than the expected 402 challenge. This may indicate the particular wallet address is not indexed, or the URL path uses a legacy `/api/data/` prefix instead of the documented `/api/x402/` prefix. The OpenAPI spec documents the canonical path as `/api/x402/wallets/{address}/stats`. Callers should prefer the `/api/x402/` path.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address in the x402 ecosystem
- —Monitor a wallet's x402 micropayment 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 spending history across x402-enabled APIs
Fit
Best for
- —Developers building analytics on x402 micropayment flows
- —AI agents that need to inspect their own or others' x402 spending
- —Researchers studying x402 protocol adoption and usage patterns
Not for
- —General-purpose blockchain explorers (this only covers x402 protocol transfers)
- —Querying non-USDC token transfers or arbitrary on-chain activity
- —Real-time streaming of transactions (this returns aggregate snapshots)
Quick start
curl -H 'X-Payment: <x402_payment_header>' \
'https://www.x402scan.com/api/x402/wallets/0x0412ab03b5f9e7ed96b0419c4c8bdd63220d4e0f/stats?chain=base&timeframe=7'Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters, pricing ($0.01/call), and endpoint descriptions. However, the probed endpoint returned 404 (not the expected 402 challenge), the URL uses a /api/data/ prefix that doesn't match the documented /api/x402/ path, no response schema or example responses are provided, and no dedicated docs page exists.
Warnings
- —Probe returned 404 on both GET and POST — the endpoint at the /api/data/ path may be deprecated or the specific wallet address may not be indexed. The OpenAPI spec documents the canonical path as /api/x402/wallets/{address}/stats.
- —No response schema is documented in the OpenAPI spec; response structure must be inferred.
- —No dedicated documentation page found (/docs, /api, /pricing all return 404).
Citations
- —The endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —Supports filtering by chain (base, solana) and timeframe (1, 7, 14, 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 documents canonical path as /api/x402/wallets/{address}/stats with operationId x402_wallets_statshttps://www.x402scan.com