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 amount sent, and unique recipients for a given sender address. It supports optional query parameters to filter by 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.
Note: The specific URL listed here hardcodes a particular wallet address (`0x275771a0aeb2b058728dbcd39170cb294e5ce316`). The general-purpose endpoint is `/api/x402/wallets/{address}/stats` where `{address}` is any wallet address. The probe returned 404 for this specific address, which may indicate the address has no indexed data or the URL path uses a different routing scheme than the OpenAPI spec describes (the spec uses `/api/x402/wallets/{address}/stats` while the probed URL uses `/api/data/wallets/{address}/stats`). The broader x402scan API is live and well-documented via OpenAPI, with the origin returning HTTP 200.
Capabilities
Use cases
- —Retrieve aggregate spending statistics for a wallet participating in x402 payments
- —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 patterns across x402-enabled APIs
Fit
Best for
- —Agents needing to check their own x402 spending history
- —Analytics tools tracking x402 ecosystem wallet activity
- —Developers building x402 payment monitoring dashboards
Not for
- —Looking up non-x402 on-chain transactions (only indexes x402 protocol transfers)
- —Real-time streaming of wallet events (returns aggregate snapshots only)
- —Wallets on chains other than Base and Solana
Quick start
curl -H "X-Payment: <x402-payment-header>" \
"https://www.x402scan.com/api/x402/wallets/0x275771a0aeb2b058728dbcd39170cb294e5ce316/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is thorough and describes the wallet stats endpoint clearly with parameters, pricing, and supported chains. However, the probed URL (/api/data/wallets/...) returned 404 and differs from the OpenAPI path (/api/x402/wallets/...), suggesting the listed endpoint URL may be incorrect or outdated. No response schema or example response is documented.
Warnings
- —The probed endpoint URL uses /api/data/wallets/ but the OpenAPI spec defines /api/x402/wallets/ — the listed URL may be incorrect or deprecated.
- —Probe returned 404 on both GET and POST, so this specific URL is not responding with a 402 challenge. The correct path is likely /api/x402/wallets/{address}/stats.
- —No response schema is provided in the OpenAPI spec — the shape of the returned stats object is unknown.
Citations
- —The 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 path as /api/x402/wallets/{address}/stats, not /api/data/wallets/{address}/statshttps://www.x402scan.com