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. Given a wallet address (as a path parameter), it returns metrics such as transaction count, total transfer volume, and unique recipients. The data 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 USDC transfers made via the x402 micropayment protocol across Base and Solana chains. The broader API suite includes endpoints for merchant stats, facilitator analytics, resource registry, full-text search across x402 resources, and even a USDC send endpoint.
This specific wallet stats endpoint costs $0.01 per call, paid via the x402 protocol (USDC micropayment). Note: the probe returned 404 for this endpoint, which appears to be because the URL uses a legacy path pattern (`/api/data/wallets/...`) rather than the documented path (`/api/x402/wallets/{address}/stats`). The canonical endpoint per the OpenAPI spec is at `/api/x402/wallets/{address}/stats`. The underlying service at x402scan.com is live (root returns 200) and the OpenAPI spec is well-documented.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address in the x402 ecosystem
- —Monitor a wallet's x402 transaction count and volume over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption per wallet
- —Audit an agent's spending history via the x402 protocol
Fit
Best for
- —Agents needing to inspect their own x402 spending history
- —Analytics tools tracking x402 protocol adoption metrics
- —Developers building wallet dashboards for x402-enabled services
Not for
- —General-purpose blockchain explorers (only covers x402 protocol transfers)
- —Non-USDC token analytics
- —Real-time streaming transaction feeds
Quick start
curl -X GET 'https://www.x402scan.com/api/x402/wallets/0xc1c04c6683cca44c1b600c6592bf7f26dee2387b/stats?chain=base&timeframe=7' \
-H 'X-Payment: <x402_payment_token>'Endpoint
Quality
The OpenAPI spec is thorough with clear parameter definitions and pricing, but the probed URL returned 404 (likely a legacy/incorrect path). No response schema or example responses are documented. The canonical path from the spec differs from the listed endpoint URL.
Warnings
- —Probed endpoint path /api/data/wallets/{address}/stats returned 404; the OpenAPI spec documents the canonical path as /api/x402/wallets/{address}/stats — the listed URL may be outdated or incorrect.
- —No response schema is defined in the OpenAPI spec — response structure must be inferred at runtime.
- —No example responses are available in the documentation.
Citations
- —The 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 supports chain filter (base, solana) and timeframe filter (1, 7, 14, 30 days)https://www.x402scan.com
- —The canonical OpenAPI path is /api/x402/wallets/{address}/statshttps://www.x402scan.com