Aggregate wallet stats (tx count, volume, unique recipients) for any x402 address, $0.01 per call.
What it does
This endpoint returns aggregate statistics for a specific wallet address within the x402 payment ecosystem. Given a wallet address in the URL path, it returns metrics such as transaction count, total transfer amount, and unique recipients. Results can be filtered by chain (Base or Solana) and by timeframe (1, 7, 14, or 30 days lookback).
The endpoint is part of x402scan, a payment data explorer and analytics dashboard for the x402 protocol, built by Merit Systems. x402scan indexes USDC transfers made via x402 micropayments across Base and Solana chains, tracking buyers, merchants, facilitators, and resources. The wallet stats endpoint costs $0.01 per request, paid via an x402 micropayment in the X-Payment header.
Note: The probe returned 404 for this specific URL path (`/api/data/wallets/{address}/stats`), but the OpenAPI spec documents the equivalent endpoint at `/api/x402/wallets/{address}/stats`. The URL in the listing uses `/api/data/` while the canonical path appears to be `/api/x402/`. The endpoint may have been moved or the listing URL may be outdated. The broader x402scan origin is live (root returns 200) and the OpenAPI spec is well-documented with clear pricing and parameter schemas.
Capabilities
Use cases
- —Retrieve aggregate spending stats for an x402 buyer wallet
- —Monitor a wallet's transaction count and volume over configurable timeframes
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participant behavior
- —Audit a wallet's unique recipient count for compliance or analytics
Fit
Best for
- —Agents needing quick wallet-level x402 payment summaries
- —Analytics pipelines tracking x402 ecosystem activity
- —Developers building on the x402 protocol who need wallet insights
Not for
- —Looking up non-x402 (general ERC-20) transfer history
- —Real-time streaming transaction feeds
- —Wallets on chains other than Base or Solana
Quick start
curl -X GET "https://www.x402scan.com/api/x402/wallets/0x4ff7080fee93dd372e89e5fc828e861a30e9eb52/stats?chain=base&timeframe=7" \
-H "X-Payment: <x402-payment-token>"Endpoint
Quality
The OpenAPI spec is thorough with clear pricing ($0.01) and parameter definitions, but the probed URL (/api/data/) returned 404 while the spec documents /api/x402/. No response schema or example responses are provided. The endpoint path mismatch is a significant concern.
Warnings
- —Probed URL path /api/data/wallets/{address}/stats returned 404; the canonical OpenAPI path is /api/x402/wallets/{address}/stats — the listing URL may be outdated or incorrect.
- —No response schema or example response is documented in the OpenAPI spec.
- —No dedicated docs page found (x402scan.com/docs returns 404).
Citations
- —Wallet stats endpoint is documented at /api/x402/wallets/{address}/stats with $0.01 fixed pricehttps://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 require $0.01–$0.02 x402 micropaymentshttps://www.x402scan.com
- —Supports filtering by chain (base, solana) and timeframe (1, 7, 14, or 30 days)https://www.x402scan.com