Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol explorer.
What it does
This endpoint returns aggregate statistics for a specific wallet address within the x402 payment ecosystem. Given a wallet address, it reports metrics such as transaction count, total transfer volume, and unique recipients. The data covers x402 micropayment transfers on both Base and Solana chains, with optional filtering by chain and 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 transfers and exposes them through a suite of paid data endpoints. This particular endpoint costs $0.01 per call, payable via the x402 micropayment protocol (X-Payment header). The broader x402scan API also offers merchant stats, facilitator analytics, resource search, a registry for x402 resources, and a USDC send function.
Note: the probe returned 404 for this specific URL, which uses the path pattern `/api/data/wallets/{address}/stats`. However, the OpenAPI spec documents the equivalent endpoint at `/api/x402/wallets/{address}/stats`. The listed URL may use a legacy or alternate path prefix. Callers should prefer the `/api/x402/` path documented in the OpenAPI specification.
Capabilities
Use cases
- —Retrieve aggregate spending stats for a wallet that uses x402 micropayments
- —Monitor transaction volume and recipient diversity for a specific address over time
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participation per wallet
Fit
Best for
- —Agents or apps that need per-wallet x402 payment analytics
- —Monitoring spending patterns of x402-enabled wallets
- —Auditing or reporting on x402 micropayment activity
Not for
- —General-purpose blockchain explorers needing full transaction details beyond x402 transfers
- —Wallets or addresses not participating in the x402 protocol
- —Free or unauthenticated bulk data access
Quick start
curl -X GET \
'https://www.x402scan.com/api/x402/wallets/0x0F1CCF4eDd29a3bCa68dAb4e24D8d0D01a33cCC2/stats?chain=base&timeframe=30' \
-H 'X-Payment: <x402_payment_token>'Example
Response
{
"chain": "base",
"address": "0x0F1CCF4eDd29a3bCa68dAb4e24D8d0D01a33cCC2",
"tx_count": 142,
"timeframe": 30,
"total_volume": "3.58",
"unique_recipients": 12
}Endpoint
Quality
The OpenAPI spec is thorough with clear parameter definitions and pricing, but the probed URL returned 404 (the canonical path appears to be /api/x402/ not /api/data/). No response schema or example responses are documented. The example response JSON above is inferred from the endpoint summary and parameter names.
Warnings
- —Probe returned 404 on the listed URL path /api/data/wallets/{address}/stats; the OpenAPI spec documents the endpoint at /api/x402/wallets/{address}/stats instead — the listing URL may be stale or incorrect.
- —No response schema is provided in the OpenAPI spec; the example response is inferred and may not match actual output.
- —No dedicated documentation page exists (x402scan.com/docs returns 404).
Citations
- —Endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —OpenAPI spec documents the wallet stats endpoint at /api/x402/wallets/{address}/stats with chain and timeframe 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
- —Supports Base and Solana chains with timeframe lookback of 1, 7, 14, or 30 dayshttps://www.x402scan.com