Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol explorer.
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 for the x402 protocol, built by Merit Systems. The wallet stats endpoint provides metrics such as transaction count, total transfer amount, and unique recipients for any wallet that has sent x402 payments on Base or Solana.
The endpoint accepts optional query parameters to filter by chain (base or solana) and timeframe (1, 7, 14, or 30 days lookback). It costs $0.01 per call, paid via the x402 micropayment protocol. The specific URL listed here queries a hardcoded wallet address (0xb238a0...cccce0), but the same pattern works for any wallet address by substituting the path parameter.
Note: During probing, this specific URL returned 404 rather than the expected 402 challenge. The canonical OpenAPI path is `/api/x402/wallets/{address}/stats`, but the listed endpoint uses `/api/data/wallets/{address}/stats` — the `/api/data/` prefix does not match the documented `/api/x402/` prefix. This may indicate the URL is stale or was migrated. The broader x402scan API is well-documented with a full OpenAPI 3.1.0 spec covering wallet, merchant, facilitator, and resource data endpoints.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address on Base or Solana
- —Monitor x402 protocol spending activity for a given wallet over configurable timeframes
- —Analyze unique recipient counts and total volume for wallets participating in x402 payments
Fit
Best for
- —Agents needing on-chain x402 payment analytics per wallet
- —Dashboards tracking x402 protocol wallet activity
- —Developers building on the x402 micropayment ecosystem
Not for
- —General-purpose blockchain explorers (only covers x402 protocol transfers)
- —Querying non-USDC token transfers or arbitrary ERC-20 activity
- —Real-time streaming of transactions (this returns aggregate snapshots)
Quick start
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0xb238a0173e71309c9da2671569d4465350cccce0/stats?chain=base&timeframe=7"Endpoint
Quality
The listed endpoint URL uses /api/data/ prefix which returned 404 on probe, not matching the documented /api/x402/ prefix in the OpenAPI spec. No response schema or example responses are provided. The broader API is well-documented via OpenAPI but this specific URL appears stale or incorrect.
Warnings
- —Endpoint returned 404 on both GET and POST — the URL path /api/data/wallets/... does not match the documented /api/x402/wallets/... pattern and may be outdated or incorrect.
- —No response schema or example response is available in the OpenAPI spec for any data endpoint.
- —The hardcoded wallet address in the URL limits reusability; the canonical parameterized path is /api/x402/wallets/{address}/stats.
Citations
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systems.https://www.x402scan.com
- —The wallet stats endpoint costs $0.01 per call and accepts chain and timeframe query parameters.https://www.x402scan.com
- —The OpenAPI spec documents the canonical path as /api/x402/wallets/{address}/stats.https://www.x402scan.com
- —Supported chains are Base and Solana; timeframe options are 1, 7, 14, or 30 days.https://www.x402scan.com