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, 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). It is part of x402scan, a payment data explorer and analytics dashboard for the x402 protocol, built by Merit Systems.
The endpoint is accessed via GET at `/api/x402/wallets/{address}/stats` and costs $0.01 per request, paid via the x402 micropayment protocol (USDC). Note that the specific URL listed here hard-codes a particular wallet address (`0xebabf40a5cf7f875db46bc31a02d3a08a542c188`), but the underlying API supports any wallet address as a path parameter. The probe returned a 404 rather than the expected 402 challenge, which may indicate the specific address has no indexed data or that the URL path uses `/data/wallets/` instead of the canonical `/x402/wallets/` documented in the OpenAPI spec.
x402scan indexes x402 payment transfers across Base and Solana chains and tracks ecosystem-wide metrics including buyers, merchants, and facilitators. The broader API suite includes endpoints for merchant stats, transaction histories, facilitator analytics, resource search, and a registry for discovering x402-protected resources.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet participating in x402 transfers
- —Monitor a wallet's x402 spending activity over configurable time windows (1, 7, 14, or 30 days)
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participation by wallet
Fit
Best for
- —Agents needing quick wallet-level x402 payment summaries
- —Analytics pipelines monitoring x402 protocol adoption per wallet
- —Developers building x402 ecosystem dashboards
Not for
- —General-purpose blockchain explorers (only covers x402 USDC transfers, not all on-chain activity)
- —Wallets or addresses not participating in the x402 protocol
- —Real-time streaming transaction feeds (this returns aggregate snapshots)
Quick start
curl -H 'X-Payment: <x402-payment-header>' \
'https://www.x402scan.com/api/x402/wallets/0xebabf40a5cf7f875db46bc31a02d3a08a542c188/stats?chain=base&timeframe=7'Endpoint
Quality
Full OpenAPI spec with clear parameter definitions and pricing is available, but the specific probed URL returned 404 (not the expected 402 challenge), no response schema is documented, and no example responses are provided. The probed path (/api/data/wallets/...) differs from the OpenAPI-documented path (/api/x402/wallets/...), suggesting the listed endpoint URL may be incorrect.
Warnings
- —Probe returned 404 on both GET and POST — the listed URL path /api/data/wallets/ does not match the OpenAPI-documented path /api/x402/wallets/. The endpoint may work at the canonical path but the specific listing URL appears broken.
- —No response schema is documented in the OpenAPI spec; the shape of the returned stats object is unknown.
- —No example responses are available from docs or crawl.
Citations
- —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
- —Returns aggregate stats: tx count, total amount, unique recipientshttps://www.x402scan.com
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —OpenAPI spec documents the canonical path as /api/x402/wallets/{address}/statshttps://www.x402scan.com