Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address.
What it does
This endpoint returns aggregate statistics for a specific wallet address that has sent x402 micropayments. It is part of the x402scan suite — a payment data explorer and analytics platform for the x402 protocol ecosystem, built by Merit Systems. The endpoint is located at `/api/x402/wallets/{address}/stats` but the specific listing URL hardcodes a particular wallet address (`0x9f5fcf4bbdcdaf0c1d63acd39fbd1dc0281e6dbe`).
The endpoint accepts optional query parameters to filter by chain (`base` or `solana`) and timeframe (1, 7, 14, or 30 days lookback). According to the OpenAPI spec, it returns aggregate stats including transaction count, total amount, and unique recipients. The price is a fixed $0.01 per call, paid via the x402 protocol (USDC micropayment). The broader x402scan API offers related endpoints for merchant stats, transaction histories, facilitator analytics, resource search, and a registry for x402-protected resources.
Note: The probe returned HTTP 404 when testing this specific URL path. The OpenAPI spec defines the endpoint pattern as `/api/x402/wallets/{address}/stats`, but the listing URL uses `/api/data/wallets/{address}/stats` (with an extra `/data/` segment). This path mismatch likely explains the 404. The canonical endpoint at `/api/x402/wallets/{address}/stats` is expected to be live based on the OpenAPI specification and the overall site being operational (root returns 200).
Capabilities
Use cases
- —Retrieve aggregate spending stats for a wallet that has made x402 micropayments
- —Monitor transaction count and volume for a specific sender address over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participation by wallet
Fit
Best for
- —Agents or apps that need quick wallet-level summaries of x402 payment activity
- —Analytics dashboards monitoring the x402 micropayment ecosystem
- —Developers building on x402 who want to track their own wallet spend
Not for
- —General-purpose blockchain transaction lookups outside the x402 ecosystem
- —Querying wallets that only receive (use the merchant stats endpoint instead)
- —Free or high-volume bulk data extraction (each call costs $0.01)
Quick start
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0x9f5fcf4bbdcdaf0c1d63acd39fbd1dc0281e6dbe/stats?chain=base&timeframe=30"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameter definitions and pricing, but the actual listed endpoint URL uses a different path prefix (/api/data/) than the spec (/api/x402/), and the probe returned 404 on both GET and POST. No response schema or example responses are provided. The site root is live (200) and the broader API suite appears operational.
Warnings
- —The listing URL path /api/data/wallets/{address}/stats returned 404; the OpenAPI spec defines the endpoint at /api/x402/wallets/{address}/stats — the listing URL may be incorrect or outdated.
- —No response schema or example responses are documented in the OpenAPI spec.
- —Probe did not capture a 402 challenge for this specific endpoint, so liveness cannot be confirmed for this exact URL.
Citations
- —The endpoint returns aggregate stats for a wallet including tx count, total amount, and unique recipientshttps://www.x402scan.com
- —Price is a fixed $0.01 per call via x402 protocolhttps://www.x402scan.com
- —Supports chain filter (base, solana) and timeframe filter (1, 7, 14, 30 days)https://www.x402scan.com
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com