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 USDC transfers made via the x402 micropayment protocol across Base and Solana. The broader API suite includes endpoints for merchant stats, buyer rankings, facilitator analytics, resource registry, and full-text search across x402 resources. All data endpoints cost $0.01–$0.02 per call, paid via the x402 protocol itself (HTTP 402 challenge with X-Payment header).
Note: The probe returned 404 for this specific endpoint URL, which embeds a particular wallet address in the path. The OpenAPI spec documents the parameterized route `/api/x402/wallets/{address}/stats` as a live x402-gated endpoint at $0.01 per call. The 404 likely indicates the hardcoded address in the listing URL has no indexed data, or the URL path format differs slightly from the canonical route (`/api/x402/wallets/` vs `/api/data/wallets/`). The canonical OpenAPI path uses `/api/x402/wallets/{address}/stats`.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for any wallet participating 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 spend
Fit
Best for
- —Developers building analytics on top of the x402 micropayment protocol
- —AI agents that need to inspect their own or others' x402 spending history
- —Researchers studying x402 protocol adoption and payment flows
Not for
- —General-purpose blockchain explorers needing full ERC-20 transfer history beyond x402
- —Querying non-USDC token transfers or non-x402 payment activity
- —Free/unauthenticated bulk data access — every call costs $0.01 via x402
Quick start
curl -H "X-Payment: <x402_payment_token>" \
"https://www.x402scan.com/api/x402/wallets/0x0869a14bfe729829ac3ff9b60a44d71caf63e3ea/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameter definitions and pricing, but the specific endpoint URL in the listing returned 404 (the canonical path appears to be /api/x402/wallets/{address}/stats, not /api/data/wallets/{address}/stats). No response schema or example responses are provided. No dedicated docs page exists.
Warnings
- —The listing URL uses /api/data/wallets/ but the OpenAPI spec documents /api/x402/wallets/{address}/stats — the endpoint path may be incorrect in the listing.
- —Probe returned 404 on both GET and POST for the listed URL, so liveness at this exact path is unconfirmed.
- —No response schema or example response is documented in the OpenAPI spec.
- —No dedicated documentation page found (/docs returns 404).
Citations
- —The endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —The canonical OpenAPI path is /api/x402/wallets/{address}/stats with 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
- —Data endpoints support filtering by chain (base, solana) and timeframe (1, 7, 14, or 30 days)https://www.x402scan.com
- —The wallet stats endpoint returns aggregate stats: tx count, total amount, unique recipientshttps://www.x402scan.com