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 data endpoints covering merchants, facilitators, resources, and transaction histories.
Access costs $0.01 per call, paid via the x402 micropayment protocol. Note: the specific URL listed here hard-codes a particular wallet address (`0x8c700294a8656e26ddf104cd87e5604bc297cab8`) in the path. The probe returned 404 rather than the expected 402 challenge, which may indicate this specific address is not indexed or the URL path format has changed (the OpenAPI spec uses `/api/x402/wallets/{address}/stats` rather than `/api/data/wallets/{address}/stats`). The canonical path appears to be `/api/x402/wallets/{address}/stats`.
Capabilities
Use cases
- —Retrieve aggregate spending stats for a wallet that has made x402 payments
- —Monitor a wallet's transaction count and volume over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption per wallet
- —Audit agent spending by querying wallet-level summaries
Fit
Best for
- —Agents or dashboards needing quick wallet-level x402 spending summaries
- —Developers building analytics on top of the x402 payment protocol
- —Monitoring x402 buyer activity across Base and Solana
Not for
- —General-purpose blockchain explorer queries outside the x402 ecosystem
- —Querying non-USDC token transfers or arbitrary on-chain data
- —Free/unauthenticated access — requires x402 micropayment per call
Quick start
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0x8c700294a8656e26ddf104cd87e5604bc297cab8/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters and pricing, but the specific endpoint URL in the listing uses /api/data/ instead of the canonical /api/x402/ path, and the probe returned 404 rather than 402. No response schema or example responses are provided. No crawled documentation pages were found.
Warnings
- —Probe returned 404 on both GET and POST — the listed URL path (/api/data/wallets/…) does not match the OpenAPI spec path (/api/x402/wallets/…). The endpoint may work at the canonical /api/x402/ path.
- —No response schema or example responses are documented in the OpenAPI spec.
- —No dedicated documentation pages were found (docs, pricing, README all return 404).
Citations
- —Wallet stats endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —Supports filtering by chain (base, solana) and timeframe (1, 7, 14, or 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
- —OpenAPI spec defines the canonical path as /api/x402/wallets/{address}/statshttps://www.x402scan.com