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 transfer amount, and unique recipients for a given sender wallet. Results can be filtered by chain (Base or Solana) and by timeframe (1, 7, 14, or 30 days lookback). The endpoint is part of a broader suite of x402scan data APIs covering merchants, facilitators, resources, and full-text search.
Access costs $0.01 per call, paid via the x402 micropayment protocol. Note: the specific URL listed here hard-codes a particular wallet address (`0x7509ded4ce9c08636ffb94bdb5435b10652608f9`) 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 format differs from the canonical OpenAPI route (`/api/x402/wallets/{address}/stats` vs `/api/data/wallets/{address}/stats`). The OpenAPI spec documents the endpoint under `/api/x402/wallets/{address}/stats`, but the listed URL uses `/api/data/wallets/...`, suggesting a path mismatch.
Capabilities
Use cases
- —Retrieve aggregate spending stats for a wallet participating in x402 micropayments
- —Monitor transaction volume and unique recipient counts for a specific sender address
- —Filter wallet activity by chain (Base or Solana) and time window
- —Build dashboards tracking x402 protocol adoption per wallet
- —Audit agent spending across x402-enabled API endpoints
Fit
Best for
- —Agents or dashboards needing quick wallet-level summaries of x402 payment activity
- —Developers analyzing x402 protocol usage patterns
- —Monitoring tools tracking USDC micropayment flows on Base and Solana
Not for
- —General-purpose blockchain explorers (this only covers x402 protocol transfers)
- —Wallets or addresses not participating in the x402 ecosystem
- —Real-time streaming transaction feeds (this returns aggregate snapshots)
Quick start
curl -H "X-Payment: <x402_payment_token>" \
"https://www.x402scan.com/api/x402/wallets/0x7509ded4ce9c08636ffb94bdb5435b10652608f9/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameter definitions and pricing, but the actual listed endpoint URL (/api/data/wallets/...) returned 404 on both GET and POST, suggesting a path mismatch with the canonical /api/x402/wallets/... route. No response schema or example responses are provided. No crawled documentation pages were found.
Warnings
- —Endpoint returned 404 on both GET and POST probes — the listed URL path (/api/data/wallets/...) does not match the OpenAPI-documented path (/api/x402/wallets/{address}/stats). The endpoint may work at the /api/x402/ path instead.
- —No response schema or example responses are documented in the OpenAPI spec.
- —The URL hard-codes a specific wallet address; the address may not be indexed, contributing to the 404.
Citations
- —Wallet stats endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —OpenAPI spec documents the route as /api/x402/wallets/{address}/stats with chain and timeframe query parametershttps://www.x402scan.com
- —x402scan is described as a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —Data endpoints support Base and Solana chainshttps://www.x402scan.com