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 priced at $0.01 per call via the x402 micropayment protocol. The specific URL listed here queries a hardcoded wallet address (0xf67f…9ab), but the same pattern applies to any wallet address substituted into the path.
Note: during probing, this specific URL returned 404 rather than the expected 402 challenge. The canonical OpenAPI path is `/api/x402/wallets/{address}/stats`, but the listed endpoint uses `/api/data/wallets/{address}/stats` — the `/api/data/` prefix does not match the documented routes. This may indicate a stale or incorrect URL. The broader x402scan origin is live (HTTP 200) and the OpenAPI spec documents the correct wallet stats endpoint at the `/api/x402/` prefix.
Capabilities
Use cases
- —Retrieve aggregate payment statistics 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
Fit
Best for
- —Agents needing quick wallet-level payment summaries in the x402 ecosystem
- —Analytics pipelines monitoring x402 protocol usage
- —Developers building on top of x402 who need sender-side metrics
Not for
- —Querying non-x402 on-chain transactions or general blockchain data
- —Looking up merchant/recipient stats (use the merchant stats endpoint instead)
- —Free or unauthenticated access — requires x402 micropayment per call
Quick start
curl -H "X-Payment: <x402_payment_token>" \
"https://www.x402scan.com/api/x402/wallets/0xf67f5491980b790d4da17266e61355b4a86899ab/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is thorough and documents the canonical wallet stats endpoint well, but the actual listed URL uses a different path prefix (/api/data/ vs /api/x402/) and returned 404 on probe. No response schema or example responses are provided. The endpoint may be stale or mis-registered.
Warnings
- —The listed endpoint path /api/data/wallets/{address}/stats returned 404; the documented OpenAPI path is /api/x402/wallets/{address}/stats — the URL may be incorrect or outdated.
- —No response schema or example response is available in the OpenAPI spec.
- —This listing is for a single hardcoded wallet address; the general-purpose endpoint uses a path parameter.
Citations
- —The 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, built by Merit Systemshttps://www.x402scan.com
- —Supports filtering by chain (base, solana) and timeframe (1, 7, 14, or 30 days)https://www.x402scan.com
- —The probed endpoint at /api/data/wallets/.../stats returned 404 on both POST and GEThttps://www.x402scan.com/api/data/wallets/0xf67f5491980b790d4da17266e61355b4a86899ab/stats