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 on-chain x402 micropayment transfers across Base and Solana and exposes them through a suite of paid data endpoints. This particular wallet stats endpoint costs $0.01 per request, payable via the x402 protocol (USDC micropayment in the X-Payment header). The broader x402scan API also offers endpoints for transaction listings, merchant stats, facilitator analytics, resource search, a registry for x402 resources, and a USDC send function.
Note: The probe returned 404 for this specific URL path, which uses a hardcoded address in the path (`/api/data/wallets/...`). The OpenAPI spec defines the canonical path as `/api/x402/wallets/{address}/stats`. The endpoint listed here appears to use a legacy or incorrect path prefix (`/api/data/` instead of `/api/x402/`). The canonical endpoint at `/api/x402/wallets/{address}/stats` is documented in the OpenAPI spec and is expected to be live.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address in the x402 ecosystem
- —Monitor a wallet's x402 spending activity over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption per wallet
- —Audit an agent's cumulative x402 micropayment spending
Fit
Best for
- —Agents needing quick aggregate stats on x402 wallet activity
- —Analytics tools monitoring x402 protocol usage
- —Developers building x402 ecosystem dashboards
Not for
- —General-purpose blockchain explorers (covers only x402 USDC transfers, not all on-chain activity)
- —Wallets or addresses not participating in the x402 protocol
Quick start
curl -H "X-Payment: <x402_payment_token>" \
"https://www.x402scan.com/api/x402/wallets/0x1367dabac291e4d70e537d32f90a2858db483e21/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is thorough with clear parameter definitions and pricing, but the actual probed URL (/api/data/wallets/...) returned 404, suggesting the listed endpoint path is incorrect or legacy. No response schema or example responses are documented. The canonical path from the spec is /api/x402/wallets/{address}/stats.
Warnings
- —The listed endpoint path uses '/api/data/wallets/' but the OpenAPI spec defines the canonical path as '/api/x402/wallets/{address}/stats'. The probed URL returned 404, likely due to this path mismatch.
- —No response schema or example response is provided in the OpenAPI spec — the 200 response description is simply 'Successful response'.
- —No dedicated documentation page exists (x402scan.com/docs returns 404).
Citations
- —Wallet stats endpoint costs $0.01 per call, fixed price in USDhttps://www.x402scan.com
- —Canonical path is /api/x402/wallets/{address}/stats with chain and timeframe query parametershttps://www.x402scan.com
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —Supports filtering by Base and Solana chains, and timeframes of 1, 7, 14, or 30 dayshttps://www.x402scan.com