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 as a path parameter, it returns metrics such as transaction count, total transfer amount, and unique recipients. Results 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 full suite includes wallet stats, merchant stats, transaction histories, facilitator analytics, resource registry, and full-text search across registered x402 resources.
Pricing is $0.01 per request, paid via the x402 protocol (HTTP 402 challenge with X-Payment header). Note: the probe returned 404 for this specific endpoint URL, which embeds a hardcoded wallet address in the path. The broader x402scan API is documented via OpenAPI and the origin site loads successfully (HTTP 200). The 404 likely indicates the probed address has no indexed data or the URL path format differs from the canonical `/api/x402/wallets/{address}/stats` pattern documented in the OpenAPI spec.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address participating in x402 micropayments
- —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 agent or buyer spending patterns in the x402 ecosystem
- —Audit total volume and recipient diversity for a given x402 payer address
Fit
Best for
- —Agents or developers building analytics on x402 micropayment activity
- —Monitoring spending patterns of specific wallet addresses across Base and Solana
- —Quick aggregate lookups (tx count, volume, unique recipients) without paginating through individual transactions
Not for
- —General-purpose blockchain explorers — this only covers x402 protocol transfers
- —Querying wallets that have never participated in x402 payments
- —Real-time streaming of transactions (this is a polling/snapshot endpoint)
Quick start
curl -H 'X-Payment: <x402_payment_token>' \
'https://www.x402scan.com/api/x402/wallets/0xYOUR_ADDRESS/stats?chain=base&timeframe=7'Endpoint
Quality
Full OpenAPI spec with clear parameter definitions and pricing metadata is available. However, the probe returned 404 for the specific hardcoded address in the listing URL, no response schema or example responses are documented, and no crawled docs page exists. The endpoint pattern is well-defined but liveness for this exact URL is unconfirmed.
Warnings
- —Probe returned 404 for the specific URL with hardcoded address 0xde092a9a3889cddcd53317647cb1ef6a50794ab6; the address may not exist in the index or the URL path may differ from the canonical /api/x402/wallets/{address}/stats pattern.
- —No response schema or example responses are documented in the OpenAPI spec.
- —No dedicated documentation page exists (/docs returns 404).
Citations
- —Endpoint returns aggregate stats for a wallet including tx count, total amount, and unique recipients, priced at $0.01 per call via x402https://www.x402scan.com
- —x402scan is 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
- —OpenAPI spec documents the /api/x402/wallets/{address}/stats endpoint with chain and timeframe query parametershttps://www.x402scan.com