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. 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 x402 micropayment transfers across Base and Solana and exposes them through a suite of paid data endpoints. This particular endpoint costs $0.01 per request, payable via the x402 protocol (HTTP 402 challenge with X-Payment header). The broader x402scan API also offers endpoints for merchant stats, transaction histories, facilitator analytics, resource registry search, and even USDC send functionality.
Note: The probe returned HTTP 404 for this specific URL path, which uses a non-standard path prefix (`/api/data/wallets/...`) rather than the documented `/api/x402/wallets/{address}/stats` path from the OpenAPI spec. The documented endpoint at `/api/x402/wallets/{address}/stats` is the canonical route. The address in the listing URL may simply be an example or the path prefix may have changed. The OpenAPI spec and the broader x402scan site are live and well-documented.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address across x402 transactions
- —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 tools monitoring x402 protocol adoption
- —Developers building on the x402 micropayment ecosystem
Not for
- —General-purpose blockchain explorers needing full transaction detail beyond x402 transfers
- —Users who need free unlimited access — every call costs $0.01 via x402
Quick start
curl -H "X-Payment: <x402-payment-token>" \
"https://www.x402scan.com/api/x402/wallets/0xf50ba48d47dc8efe42a21b662b2e73121fa11351/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is thorough with clear parameter definitions and pricing, but the specific probed URL returned 404 (path mismatch with documented routes). No response schema or example responses are provided in the spec. The crawl confirms the site is live and the broader API suite is active.
Warnings
- —The probed endpoint path /api/data/wallets/{address}/stats returned 404; the documented canonical path is /api/x402/wallets/{address}/stats — the listing URL may use an outdated or incorrect path prefix.
- —No response schema or example response bodies are documented in the OpenAPI spec.
- —No dedicated docs page exists (https://www.x402scan.com/docs returns 404); guidance is embedded in the OpenAPI spec only.
Citations
- —The endpoint costs $0.01 per call and supports chain and timeframe query parametershttps://www.x402scan.com
- —x402scan is described as a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —The OpenAPI spec documents the canonical path as /api/x402/wallets/{address}/stats with fixed price $0.01 USDhttps://www.x402scan.com
- —Data endpoints require $0.01–$0.02 x402 micropayments via X-Payment headerhttps://www.x402scan.com