Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address — $0.01 per call.
What it does
This endpoint returns aggregate statistics for a specific wallet address acting as a sender (buyer) in the x402 payment ecosystem. Given a wallet address in the URL path, it returns metrics such as transaction count, total amount sent, and unique recipients. Results can be filtered by chain (Base or Solana) and by timeframe (1, 7, 14, or 30 days lookback).
x402scan is a payment data explorer and analytics dashboard for the x402 protocol, built by Merit Systems. It indexes USDC micropayment transfers across Base and Solana chains, tracking buyers, merchants (sellers), facilitators, and registered x402 resources. The broader x402scan API suite includes endpoints for merchant stats, transaction histories, facilitator analytics, resource search, and a registry for discovering x402-protected endpoints.
This specific endpoint costs $0.01 per call, paid via the x402 micropayment protocol (HTTP 402 challenge with X-Payment header). Note: the probe returned 404 rather than 402, which may indicate the hardcoded example address in the listing URL is not recognized, or the endpoint path uses a different prefix (/api/x402/wallets/ vs /api/data/wallets/). The OpenAPI spec documents the canonical path as /api/x402/wallets/{address}/stats.
Capabilities
Use cases
- —Retrieve aggregate spending stats for a specific wallet address across x402 payments
- —Monitor a buyer's transaction count and volume over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participant behavior
- —Audit an agent's cumulative x402 micropayment spending
Fit
Best for
- —Agents needing to audit their own x402 spending history
- —Analytics dashboards tracking x402 ecosystem activity
- —Developers building on the x402 protocol who need buyer-side metrics
Not for
- —Looking up general ERC-20 or SPL token balances unrelated to x402
- —Real-time transaction streaming or webhooks
- —Querying merchant/recipient stats (use the merchant stats endpoint instead)
Quick start
curl -H "X-Payment: <x402-payment-token>" \
"https://www.x402scan.com/api/x402/wallets/0xa5067dfd0dd91c97cbf544aec3f0ca3fe89aa6ea/stats?chain=base&timeframe=30"Endpoint
Quality
Full OpenAPI schema with clear parameter definitions and pricing ($0.01 via x402). However, the probe returned 404 instead of 402 — the listed URL uses /api/data/wallets/ while the OpenAPI spec documents /api/x402/wallets/. No response schema or example responses are provided. No dedicated docs page exists.
Warnings
- —Probe returned 404 on both GET and POST — the listing URL path (/api/data/wallets/) does not match the OpenAPI canonical path (/api/x402/wallets/). The endpoint may work at the correct path.
- —No response schema documented in the OpenAPI spec — response structure must be inferred.
- —No dedicated documentation pages found (/docs, /api, /pricing all return 404).
Citations
- —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
- —Wallet stats endpoint returns aggregate stats (tx count, total amount, unique recipients) with chain and timeframe filtershttps://www.x402scan.com
- —Supports Base and Solana chainshttps://www.x402scan.com
- —Timeframe filter supports 1, 7, 14, or 30 day lookbackhttps://www.x402scan.com