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 amount, and unique recipients. The data covers x402 micropayment transfers on Base and Solana chains, and can be filtered by chain and by a timeframe lookback of 1, 7, 14, or 30 days.
The endpoint is part of x402scan, an analytics dashboard and block explorer for the x402 protocol built by Merit Systems. x402scan indexes on-chain x402 micropayment activity across multiple facilitators (Coinbase, PayAI, Meridian) and exposes it through a suite of paid data endpoints. Each data query costs $0.01 in USDC via the x402 payment protocol. The specific wallet address in this endpoint URL (0xbe812aa597e1767a0229de29ce8e14a5d8ee8570) is hardcoded, so this listing covers stats for that particular address only.
Note: The probe returned HTTP 404 on both GET and POST for this specific URL path. The OpenAPI spec documents the parameterized route at `/api/x402/wallets/{address}/stats`, but the actual endpoint URL uses `/api/data/wallets/...` which may be a legacy or alternate path. The canonical endpoint at `/api/x402/wallets/{address}/stats` is documented and likely functional. Callers should prefer the documented path.
Capabilities
Use cases
- —Retrieve aggregate payment stats for a specific wallet participating in x402 micropayments
- —Monitor a wallet's x402 spending activity over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption per wallet
Fit
Best for
- —Agents needing quick wallet-level summaries of x402 micropayment activity
- —Analytics pipelines monitoring x402 ecosystem participants
- —Developers building on top of the x402 protocol who need wallet metrics
Not for
- —General-purpose blockchain explorers needing full transaction history (use the transactions endpoint instead)
- —Querying wallets outside the x402 payment ecosystem
- —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/0xbe812aa597e1767a0229de29ce8e14a5d8ee8570/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is thorough and documents the parameterized wallet stats endpoint with clear parameters and pricing ($0.01 per call). However, the specific endpoint URL probed (/api/data/wallets/...) returned 404, suggesting a path mismatch versus the documented /api/x402/wallets/{address}/stats route. No response schema or example responses are provided. The address is hardcoded in the listing URL, limiting generality.
Warnings
- —Probe returned 404 on both GET and POST — the URL path /api/data/wallets/ may be deprecated or incorrect; the documented path is /api/x402/wallets/{address}/stats
- —No response schema or example response available in the OpenAPI spec
- —The endpoint URL contains a hardcoded wallet address; the general parameterized endpoint is /api/x402/wallets/{address}/stats
- —No dedicated documentation page found (x402scan.com/docs returns 404)
Citations
- —Wallet stats endpoint is documented at /api/x402/wallets/{address}/stats with $0.01 fixed pricehttps://www.x402scan.com
- —x402scan is described as 'a payment data explorer and registry for the x402 protocol' by Merit Systemshttps://www.x402scan.com
- —Data endpoints support chain filter (base, solana) and timeframe lookback (1, 7, 14, or 30 days)https://www.x402scan.com
- —x402scan tracks facilitators including Coinbase, PayAI, and Meridianhttps://www.x402scan.com