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. It is part of x402scan, a payment data explorer and analytics dashboard for the x402 protocol built by Merit Systems. The wallet stats endpoint provides metrics such as transaction count, total transfer amount, and unique recipients for any wallet that has sent x402 payments.
The endpoint accepts optional query parameters to filter by chain (Base or Solana) and timeframe (1, 7, 14, or 30 days lookback). It is a GET request that costs $0.01 per call, paid via the x402 micropayment protocol. The specific URL includes a hardcoded wallet address (0x09c002675733c7c36f37320a58870ec2782230d8), but the underlying API pattern is `/api/x402/wallets/{address}/stats` where any valid wallet address can be substituted.
Note: During probing, this specific wallet address returned a 404 rather than the expected 402 payment challenge. This may indicate the address is not indexed or the URL path uses a different routing scheme (`/api/data/wallets/` vs the documented `/api/x402/wallets/`). The OpenAPI spec documents the canonical path as `/api/x402/wallets/{address}/stats`. The broader x402scan platform appears live and healthy (root returns 200), and the OpenAPI spec is comprehensive with 13 documented endpoints.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address in the x402 ecosystem
- —Monitor wallet activity over configurable time windows (1, 7, 14, or 30 days)
- —Compare wallet behavior across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption by wallet
Fit
Best for
- —Agents needing quick wallet-level summaries of x402 payment activity
- —Analytics pipelines monitoring x402 protocol usage
- —Developers building on top of x402 who need sender-side metrics
Not for
- —Looking up non-x402 on-chain transactions or general blockchain data
- —Querying merchant/recipient stats (use the merchants/stats endpoint instead)
- —Free or unauthenticated access — requires $0.01 x402 micropayment per call
Quick start
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0x09c002675733c7c36f37320a58870ec2782230d8/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear pricing, parameters, and endpoint descriptions. However, the probed endpoint URL (/api/data/wallets/...) returned 404 on both GET and POST, and differs from the documented canonical path (/api/x402/wallets/...). No response schema or example responses are provided. The combination of a non-responding specific URL and missing response schemas lowers confidence.
Warnings
- —The probed URL uses /api/data/wallets/ but the OpenAPI spec documents /api/x402/wallets/ — the listing URL may be incorrect or outdated.
- —Probe returned 404 on both GET and POST; the endpoint at this exact URL may not be live.
- —No response schema or example response is documented in the OpenAPI spec.
- —No dedicated docs, pricing, or README pages were found (all returned 404).
Citations
- —The wallet stats endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —The endpoint accepts chain (base, solana) and timeframe (1, 7, 14, 30 days) query 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
- —The canonical API path is /api/x402/wallets/{address}/stats per the OpenAPI spechttps://www.x402scan.com
- —x402scan supports Base and Solana chainshttps://www.x402scan.com