Aggregate wallet stats (tx count, volume, unique recipients) from the x402 payment ecosystem for $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 this case 0x53d8436f1c692fdba97daf29e2a27517206ca33a), it returns metrics such as transaction count, total transfer amount, and unique recipients. The data covers x402 protocol USDC transfers on Base and Solana chains.
The endpoint is part of x402scan, an analytics dashboard and block explorer for the x402 protocol built by Merit Systems. It indexes on-chain x402 micropayment activity across facilitators like Coinbase, PayAI, and Meridian. The wallet stats endpoint accepts optional query parameters for chain filtering (base or solana) and timeframe lookback (1, 7, 14, or 30 days).
Payment is handled via the x402 protocol at a fixed price of $0.01 per request. Note that the probe returned 404 rather than the expected 402 challenge, which may indicate the specific hardcoded wallet address in the URL has no indexed data, or the endpoint path uses a different URL structure than what was probed. The OpenAPI spec at the origin does document the generic /api/x402/wallets/{address}/stats route as live and priced at $0.01.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific x402 wallet address
- —Monitor wallet activity across Base and Solana chains over configurable timeframes
- —Build dashboards tracking x402 micropayment volume and counterparty diversity
- —Audit an agent's or buyer's x402 spending history programmatically
Fit
Best for
- —Agents needing to inspect their own x402 spending stats
- —Analytics tools tracking x402 ecosystem wallet activity
- —Developers building on the x402 protocol who need wallet-level metrics
Not for
- —General-purpose blockchain explorers (only covers x402 USDC transfers)
- —Real-time transaction streaming or webhooks
- —Wallets or tokens outside the x402 payment protocol
Quick start
curl -H "X-Payment: <x402_payment_token>" \
"https://www.x402scan.com/api/x402/wallets/0x53d8436f1c692fdba97daf29e2a27517206ca33a/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters and pricing, but the specific probed endpoint returned 404 instead of the expected 402 challenge, raising liveness concerns. No response schema or example responses are provided in the spec. The endpoint URL is hardcoded to a specific wallet address rather than being a generic route.
Warnings
- —Probe returned 404 on both GET and POST — the specific wallet address in the URL may not exist in the index, or the endpoint path may differ from the OpenAPI spec's /api/x402/wallets/{address}/stats route (note: probed URL uses /api/data/wallets/ instead of /api/x402/wallets/)
- —The probed URL path (/api/data/wallets/...) does not match the documented OpenAPI path (/api/x402/wallets/...), suggesting the listing URL may be outdated or incorrect
- —No response schema or example responses available in the OpenAPI spec
Citations
- —The wallet stats endpoint is documented at /api/x402/wallets/{address}/stats with a fixed price of $0.01https://www.x402scan.com
- —x402scan is described as a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —Supported chains are Base and Solana; timeframe options are 1, 7, 14, or 30 dayshttps://www.x402scan.com
- —The x402 ecosystem shows ~97.43K transactions and ~$17.06K volume in the past 24 hourshttps://www.x402scan.com