Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address.
What it does
This endpoint returns aggregate statistics for a given wallet address that has participated as a sender in x402 protocol transfers. It is part of the x402scan suite — a payment data explorer and analytics dashboard for the x402 ecosystem, built by Merit Systems. The endpoint accepts a wallet address as a path parameter and returns metrics such as transaction count, total amount sent, and unique recipients.
The specific URL listed here queries stats for wallet `0xbbdb7da7c240d2d8caecf17a5bd2a4e1d0b4595e`. However, the underlying operation (`x402_wallets_stats`) is parameterized: any valid wallet address can be substituted in the path. Optional query parameters include `chain` (base or solana) and `timeframe` (1, 7, 14, or 30 days lookback). The endpoint costs $0.01 per call, paid via the x402 micropayment protocol. 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 URL returned HTTP 404 rather than the expected 402 challenge. The OpenAPI spec defines the parameterized route `/api/x402/wallets/{address}/stats` under a different path prefix (`/api/x402/...`) than the probed URL (`/api/data/wallets/.../stats`). The endpoint may have been moved or the URL in the listing may be outdated. The canonical path per the OpenAPI spec is `/api/x402/wallets/{address}/stats`.
Capabilities
Use cases
- —Retrieve aggregate sending statistics for a specific wallet address across x402 transfers
- —Monitor a wallet's transaction count and total volume over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participation by wallet
- —Audit an agent's spending history on x402-protected APIs
Fit
Best for
- —Agents that need to audit their own x402 spending history
- —Analytics dashboards tracking x402 ecosystem wallet activity
- —Developers building tools on top of the x402 payment protocol
Not for
- —Looking up non-x402 on-chain transactions or general blockchain data
- —Real-time streaming of wallet events (this is a polling/query endpoint)
- —Wallets that have only received (use the merchant stats endpoint instead)
Quick start
curl -H "X-Payment: <x402-payment-header>" \
"https://www.x402scan.com/api/x402/wallets/0xbbdb7da7c240d2d8caecf17a5bd2a4e1d0b4595e/stats?chain=base&timeframe=30"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters and pricing, but the probed URL returned 404 (not the expected 402), suggesting the listed URL path (/api/data/...) is stale or incorrect versus the canonical /api/x402/... path. No response schema or example responses are provided. No crawled documentation pages were found.
Warnings
- —Probed URL returned 404 on both GET and POST — the path /api/data/wallets/.../stats may be outdated; the OpenAPI spec uses /api/x402/wallets/{address}/stats instead.
- —No response schema is documented in the OpenAPI spec — response structure must be inferred.
- —No dedicated documentation pages were 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
- —The OpenAPI spec defines the wallet stats route as /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