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 transfer amount, and unique recipients for a given sender address.
The endpoint accepts optional query parameters to filter by chain (base or solana) and timeframe (1, 7, 14, or 30 days lookback). It is gated by an x402 micropayment of $0.01 per request. Payment is made via the X-Payment header using the x402 protocol. The specific wallet address in this listing URL (0x9350131f296d4d336d12bcbc960019be2c640ccb) is hardcoded in the path, but the general pattern is `/api/x402/wallets/{address}/stats` for any wallet address.
Note: The probe returned 404 for this specific endpoint URL, which uses the path prefix `/api/data/wallets/` rather than the documented `/api/x402/wallets/`. The OpenAPI spec documents the endpoint at `/api/x402/wallets/{address}/stats`. The listed URL may be outdated or use a legacy path. The canonical endpoint pattern from the OpenAPI spec should be preferred.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific x402 sender wallet
- —Monitor wallet activity across Base and Solana chains over configurable timeframes
- —Build dashboards tracking x402 protocol usage by individual wallets
- —Audit a wallet's x402 spending history and recipient diversity
Fit
Best for
- —Agents needing on-chain x402 payment analytics for a specific wallet
- —Developers building x402 ecosystem monitoring tools
- —Analysts tracking x402 protocol adoption and wallet behavior
Not for
- —General-purpose blockchain explorers (this only covers x402 protocol transfers)
- —Real-time streaming transaction feeds (this returns aggregate snapshots)
- —Non-x402 token transfer analytics
Quick start
curl -X GET "https://www.x402scan.com/api/x402/wallets/0x9350131f296d4d336d12bcbc960019be2c640ccb/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 info, but the actual probed endpoint URL (/api/data/wallets/...) returned 404 and does not match the documented path (/api/x402/wallets/...). No response schema or example responses are provided. The endpoint may be live at the canonical path but was not confirmed.
Warnings
- —Probed URL uses /api/data/wallets/ path which returned 404; the OpenAPI spec documents the endpoint at /api/x402/wallets/{address}/stats — the listing URL may be outdated or incorrect.
- —No response schema or example response is available in the OpenAPI spec.
- —The hardcoded wallet address in the listing URL limits reusability; the general pattern /api/x402/wallets/{address}/stats should be used instead.
Citations
- —The endpoint is priced at $0.01 per request via x402 micropaymenthttps://www.x402scan.com
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —The wallet stats endpoint accepts chain (base, solana) and timeframe (1, 7, 14, 30 days) query parametershttps://www.x402scan.com
- —The canonical endpoint path is /api/x402/wallets/{address}/stats per the OpenAPI spechttps://www.x402scan.com