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 built by Merit Systems that indexes x402 protocol transfers on Base and Solana chains. The wallet stats endpoint provides metrics such as transaction count, total amount sent, and unique recipients for any wallet that has participated as a sender in x402 transfers.
The endpoint accepts optional query parameters to filter by chain (base or solana) and timeframe (1, 7, 14, or 30 days lookback). It is accessed via GET and requires an x402 micropayment of $0.01 per call. Payment is made via the X-Payment header using the x402 protocol, settling in USDC.
Note that during probing, this specific URL (which hardcodes a particular wallet address) returned 404 on both GET and POST. However, the OpenAPI spec clearly documents the parameterized path `/api/x402/wallets/{address}/stats` as a live endpoint, and the broader x402scan origin returned HTTP 200. The 404 may indicate the specific hardcoded address has no indexed data, or a routing issue with the `/api/data/` path prefix versus the documented `/api/x402/` prefix. The canonical endpoint path per the OpenAPI spec is `/api/x402/wallets/{address}/stats`.
Capabilities
Use cases
- —Retrieve aggregate sending 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 general ERC-20 or SPL token balances unrelated to x402 transfers
- —Querying merchant/recipient-side stats (use the merchants stats endpoint instead)
- —Free or unauthenticated bulk data export
Quick start
curl -X GET \
'https://www.x402scan.com/api/x402/wallets/0xd65164710a38497caf83a63db4a0649a25b2bf65/stats?chain=base&timeframe=7' \
-H 'X-Payment: <x402_payment_token>'Endpoint
Quality
The OpenAPI spec is well-documented with clear parameter definitions and pricing, but the probed URL returned 404 (possibly due to a path mismatch: /api/data/ vs /api/x402/). No response schema or example responses are provided. No dedicated docs page exists.
Warnings
- —Probed endpoint path /api/data/wallets/{address}/stats returned 404; the OpenAPI spec documents the canonical path as /api/x402/wallets/{address}/stats — the listing URL may use an incorrect prefix.
- —No response schema or example response is documented in the OpenAPI spec.
- —No dedicated documentation page found (x402scan.com/docs returns 404).
Citations
- —The endpoint is documented as GET /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 chain filter (base, solana) and timeframe filter (1, 7, 14, or 30 days)https://www.x402scan.com
- —The probed URL returned 404 on both POST and GEThttps://www.x402scan.com/api/data/wallets/0xd65164710a38497caf83a63db4a0649a25b2bf65/stats