Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address.
What it does
This endpoint returns aggregate statistics for a specific wallet address that has sent x402 protocol payments. It is part of x402scan, a payment data explorer and analytics dashboard for the x402 ecosystem built by Merit Systems. The endpoint is located at `/api/x402/wallets/{address}/stats` (note: the listing URL hardcodes a specific address, but the OpenAPI spec shows this is a parameterized path).
The stats returned include transaction count, total amount sent, and unique recipients for a given wallet. You can filter results by chain (Base or Solana) and by timeframe (1, 7, 14, or 30 days lookback). The endpoint costs $0.01 per call, paid via the x402 micropayment protocol. x402scan indexes payment data across Base and Solana chains and tracks facilitators like Coinbase, PayAI, and Meridian.
The broader x402scan API suite includes endpoints for merchant stats, transaction histories, facilitator analytics, resource search, and a registry for discovering and registering x402-protected resources. All data endpoints are priced at $0.01–$0.02 each. The specific endpoint probed returned a 404 rather than the expected 402 challenge, which may indicate the hardcoded address in the URL is not indexed, or the endpoint requires a different path format than what was probed.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific x402 sender wallet
- —Monitor wallet spending activity across Base and Solana chains
- —Analyze wallet behavior over configurable time windows (1/7/14/30 days)
- —Build dashboards tracking x402 protocol adoption per wallet
- —Audit total volume and unique recipients for a given address
Fit
Best for
- —Agents needing quick wallet-level x402 payment summaries
- —Analytics tools tracking x402 ecosystem activity
- —Developers building on the x402 protocol who need sender insights
Not for
- —General-purpose blockchain explorers (this only covers x402 protocol transfers)
- —Querying non-USDC token transfers or arbitrary on-chain data
- —Free/unauthenticated bulk data access (every call costs $0.01)
Quick start
curl -H "X-Payment: <x402_payment_token>" \
"https://www.x402scan.com/api/x402/wallets/0x44ea7b399f9b37898b3b4c3ad37f2a4dc296267e/stats?chain=base&timeframe=7"Endpoint
Quality
Full OpenAPI schema with clear pricing and parameter definitions is available, but the probed endpoint returned 404 instead of the expected 402 challenge, and no response schema or example responses are documented. No dedicated docs page exists.
Warnings
- —Probe returned 404 on both GET and POST — the hardcoded address may not be indexed, or the endpoint path may differ from the OpenAPI spec's parameterized route. The endpoint could not be confirmed live.
- —No response schema is defined in the OpenAPI spec — only '200: Successful response' with no body description.
- —No dedicated documentation pages were found (/docs, /api, /pricing all return 404).
Citations
- —Endpoint costs $0.01 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 described as a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —OpenAPI spec defines the wallets/{address}/stats endpoint with operationId x402_wallets_statshttps://www.x402scan.com