Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol ecosystem.
What it does
This endpoint returns aggregate statistics for a specific wallet address within the x402 payment ecosystem. It is part of x402scan, a payment data explorer and analytics dashboard built by Merit Systems that indexes x402 protocol transfers on Base and Solana chains.
The wallet stats endpoint accepts a wallet address as a path parameter and returns summary metrics such as transaction count, total transfer amount, and unique recipients. Optional query parameters allow filtering by chain (base or solana) and timeframe (1, 7, 14, or 30 days lookback). The endpoint costs $0.01 per call, paid via the x402 micropayment protocol using USDC.
Note: The specific endpoint URL listed here embeds a hardcoded wallet address (0x0500b19795a4e21962b01098c48c09f59e584671). The canonical parameterized path is /api/x402/wallets/{address}/stats. During probing, this specific URL returned 404 on both GET and POST, which may indicate the particular wallet address is not indexed, or the endpoint path differs from the OpenAPI spec (the spec uses /api/x402/wallets/ while the listed URL uses /api/data/wallets/). The broader x402scan origin is live (HTTP 200) and serves a comprehensive OpenAPI spec covering wallet, merchant, facilitator, and resource data endpoints.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet participating in the x402 ecosystem
- —Monitor wallet 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 protocol adoption and wallet-level metrics
- —Audit a wallet's x402 spending patterns including volume and unique recipients
Fit
Best for
- —Agents needing on-chain x402 payment analytics per wallet
- —Developers building x402 ecosystem monitoring tools
- —Analysts tracking micropayment protocol adoption on Base and Solana
Not for
- —General-purpose blockchain explorers (only covers x402 protocol transfers)
- —Querying non-USDC token transfers or arbitrary on-chain data
- —Real-time streaming of transactions (this returns aggregate snapshots)
Quick start
curl -H "X-Payment: <x402-payment-header>" \
"https://www.x402scan.com/api/x402/wallets/0x0500b19795a4e21962b01098c48c09f59e584671/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is comprehensive and pricing is clear ($0.01/call). However, the specific listed endpoint URL uses /api/data/wallets/ which does not match the OpenAPI spec path /api/x402/wallets/, and the probe returned 404 on both methods. No response schema or example responses are documented. The endpoint may be live under the correct path but the listed URL appears broken or outdated.
Warnings
- —The listed endpoint path (/api/data/wallets/...) does not match the OpenAPI spec path (/api/x402/wallets/...). The probe returned 404 on both GET and POST, suggesting the listed URL may be incorrect.
- —No response schema is documented in the OpenAPI spec — only '200: Successful response' with no body definition.
- —No example response data is available to confirm the shape of returned statistics.
Citations
- —The endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —Wallet stats endpoint supports chain (base, solana) and timeframe (1, 7, 14, 30 days) query parametershttps://www.x402scan.com
- —The OpenAPI spec defines the wallet stats path as /api/x402/wallets/{address}/statshttps://www.x402scan.com