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, tracking merchants, buyers, facilitators, and resources. The broader API suite includes endpoints for merchant stats, facilitator stats, transaction histories, resource search, and a registry for x402-protected resources.
Pricing is $0.01 USD per call, paid via the x402 micropayment protocol. The specific wallet address in this listing's URL (0x59f9d6ecf2be47d8c696dc62bef1b05b1ad6dc88) is hardcoded, but the underlying operation (x402_wallets_stats) accepts any wallet address as a path parameter. Note: the probe returned 404 rather than the expected 402 challenge, which may indicate the specific address is not indexed or the URL path format differs from the OpenAPI spec (which uses /api/x402/wallets/{address}/stats rather than /api/data/wallets/{address}/stats).
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address participating in x402 transfers
- —Monitor a wallet's x402 spending activity over configurable time windows (1, 7, 14, or 30 days)
- —Filter wallet stats by chain (Base or Solana) to analyze cross-chain payment behavior
- —Build dashboards tracking x402 ecosystem participant activity
Fit
Best for
- —Agents needing quick aggregate stats on x402 wallet activity
- —Developers building analytics on top of x402 micropayment data
- —Monitoring tools tracking wallet-level x402 spending patterns
Not for
- —General-purpose blockchain explorers needing full transaction details (use the transactions endpoint instead)
- —Non-x402 on-chain activity — this only indexes x402 protocol transfers
- —Real-time streaming of wallet events
Quick start
curl -H "X-Payment: <x402-payment-header>" \
"https://www.x402scan.com/api/x402/wallets/0x59f9d6ecf2be47d8c696dc62bef1b05b1ad6dc88/stats?chain=base&timeframe=7"Endpoint
Quality
Full OpenAPI schema is available with clear parameter definitions and pricing info. However, the probed endpoint URL (/api/data/wallets/...) returned 404 rather than 402, suggesting the listed URL may use an incorrect path prefix (should be /api/x402/wallets/...). No response schema or example responses are documented. No dedicated docs page exists.
Warnings
- —Probe returned 404 on both GET and POST — the listed endpoint URL uses /api/data/ but the OpenAPI spec defines the path as /api/x402/wallets/{address}/stats. The endpoint URL may be incorrect.
- —No response schema is documented in the OpenAPI spec — response body structure must be inferred.
- —The hardcoded wallet address in the URL may not be indexed, which could also explain the 404.
- —No dedicated documentation pages found (/docs, /api, /pricing all return 404).
Citations
- —Endpoint is priced at $0.01 USD 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
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —OpenAPI spec defines the wallet stats path as /api/x402/wallets/{address}/statshttps://www.x402scan.com
- —Returns aggregate stats: tx count, total amount, unique recipientshttps://www.x402scan.com