Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address.
What it does
This endpoint returns aggregate statistics for a given wallet address acting as a sender in the x402 payment ecosystem. It is part of x402scan, a payment data explorer and analytics platform for the x402 protocol built by Merit Systems. The specific path queried here is `/api/x402/wallets/{address}/stats`, which provides metrics such as transaction count, total amount sent, and unique recipients for the specified wallet.
The endpoint accepts optional query parameters to filter by chain (Base or Solana) and timeframe (1, 7, 14, or 30 days lookback). It costs $0.01 per call, paid via an x402 micropayment in the `X-Payment` header. The broader x402scan API suite includes endpoints for merchant stats, facilitator analytics, resource search, and a registry for x402-protected resources.
Note: During probing, this specific URL (which embeds a hardcoded wallet address in the path) returned 404 rather than the expected 402 challenge. This may indicate the particular wallet address is not indexed, or the endpoint path format differs from the OpenAPI spec's parameterized route `/api/x402/wallets/{address}/stats`. The OpenAPI spec itself is well-documented and the origin site is live (HTTP 200), so the broader API appears operational.
Capabilities
Use cases
- —Retrieve aggregate spending stats for a specific x402 sender wallet
- —Monitor wallet activity over configurable time windows (1/7/14/30 days)
- —Compare wallet behavior across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption per wallet
- —Audit agent spending patterns in the x402 ecosystem
Fit
Best for
- —Agents needing quick wallet-level spending summaries
- —Analytics dashboards tracking x402 protocol usage
- —Developers building on top of x402 payment data
Not for
- —Looking up non-x402 on-chain transactions (only indexes x402 transfers)
- —Real-time streaming transaction feeds (this is a polling/stats endpoint)
- —Wallets that have never participated in x402 payments
Quick start
curl -X GET \
'https://www.x402scan.com/api/x402/wallets/0xYOUR_ADDRESS/stats?chain=base&timeframe=7' \
-H 'X-Payment: <x402-payment-token>'Endpoint
Quality
The OpenAPI spec is thorough with clear parameter definitions and pricing, but the specific probed URL returned 404 instead of 402, so liveness of this exact path could not be confirmed. No response schema or example responses are documented. No dedicated docs page exists.
Warnings
- —Probe returned 404 on both GET and POST for the hardcoded wallet address in the URL; the wallet may not be indexed or the path may require a valid indexed address to return 402.
- —No response schema is defined in the OpenAPI spec — response structure must be inferred at runtime.
- —No dedicated documentation page found (/docs, /api, /pricing all return 404).
Citations
- —Endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —Supports chain filter (base, solana) and timeframe filter (1, 7, 14, 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 describes the wallets/{address}/stats endpoint with operationId x402_wallets_statshttps://www.x402scan.com