Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol ecosystem for $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 reports metrics such as transaction count, total transfer amount, and unique recipients. The data covers x402 micropayment transfers on Base and Solana chains, with optional filtering by chain and timeframe (1, 7, 14, or 30 days lookback).
The endpoint is part of x402scan, an analytics dashboard and block explorer for the x402 protocol built by Merit Systems. x402scan indexes on-chain x402 micropayment activity and exposes it through a suite of paid data endpoints. This particular endpoint costs $0.01 per request, payable via the x402 protocol (USDC micropayment). The broader x402scan API also offers merchant stats, facilitator analytics, resource search, transaction history, and a registry for x402-protected resources.
Note: The probe returned HTTP 404 for this specific URL path (`/api/data/wallets/{address}/stats`), while the OpenAPI spec documents the equivalent endpoint at `/api/x402/wallets/{address}/stats`. The listed URL may use a legacy or incorrect path prefix (`/api/data/` vs `/api/x402/`). Callers should use the `/api/x402/wallets/{address}/stats` path as documented in the OpenAPI specification.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address participating in x402 micropayments
- —Monitor wallet activity across Base and Solana chains over configurable time windows
- —Build dashboards tracking x402 ecosystem participation by wallet
- —Audit a wallet's x402 spending history programmatically
Fit
Best for
- —Agents needing on-chain x402 payment analytics per wallet
- —Developers building x402 ecosystem monitoring tools
- —Researchers analyzing micropayment adoption on Base and Solana
Not for
- —General-purpose blockchain explorers (covers only x402 protocol transfers)
- —Wallets or addresses not participating in the x402 ecosystem
- —Real-time streaming transaction feeds (this is an aggregate stats endpoint)
Quick start
curl -H "X-Payment: <x402_payment_token>" \
"https://www.x402scan.com/api/x402/wallets/0x88aee1537b8321f560355a59329c7ba36c47753b/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear pricing and parameter definitions, but the specific endpoint URL in the listing (/api/data/...) returned 404 during probing, suggesting a path mismatch with the documented /api/x402/ prefix. No response schema or example responses are provided. No dedicated docs page exists.
Warnings
- —Probe returned 404 on both GET and POST for the listed URL path /api/data/wallets/{address}/stats; the correct path appears to be /api/x402/wallets/{address}/stats per the OpenAPI spec
- —No response schema documented — the shape of the returned stats object is unknown
- —No example responses available in the OpenAPI spec or crawled pages
Citations
- —Endpoint costs $0.01 per request in USD via x402 protocolhttps://www.x402scan.com
- —Supports chain filter (base, solana) and timeframe filter (1, 7, 14, or 30 days)https://www.x402scan.com
- —x402scan is described as 'the x402 analytics dashboard and block explorer' built by Merit Systemshttps://www.x402scan.com
- —OpenAPI spec documents the wallet stats endpoint at /api/x402/wallets/{address}/statshttps://www.x402scan.com