Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address.
What it does
This endpoint returns aggregate statistics for a specific wallet address acting as a sender in the x402 payment ecosystem. It is part of x402scan, a payment data explorer and analytics platform for the x402 protocol built by Merit Systems. The endpoint is located at `/api/x402/wallets/{address}/stats` and accepts an Ethereum or Solana address as a path parameter.
The stats returned include transaction count, total amount sent, and unique recipients for the given wallet. Optional query parameters allow filtering by chain (base or solana) and timeframe (1, 7, 14, or 30 days lookback). The endpoint costs $0.01 per call, paid via the x402 micropayment protocol using USDC.
Note: The specific URL listed here includes a hardcoded address (`0xe2c87cdefbcf882901a81f8f01e96096c9bb42a1`). The probe returned 404 on both GET and POST, which may indicate this particular address has no indexed data or the endpoint requires the canonical path pattern `/api/x402/wallets/{address}/stats`. The broader x402scan API is live (root returns 200) and the OpenAPI spec documents this endpoint with full parameter details. The platform tracks the x402 ecosystem across Base and Solana chains, indexing merchants, buyers, facilitators, and resources.
Capabilities
Use cases
- —Retrieve aggregate spending stats for a wallet participating in x402 payments
- —Monitor a wallet's x402 transaction count and volume over configurable timeframes
- —Filter wallet activity by chain (Base or Solana) for cross-chain analytics
- —Build dashboards tracking x402 protocol adoption by wallet activity
- —Audit a specific sender's payment history in the x402 ecosystem
Fit
Best for
- —Agents needing quick aggregate stats on x402 sender wallets
- —Analytics dashboards tracking x402 protocol usage
- —Developers building on top of the x402 payment ecosystem
Not for
- —Looking up non-x402 (general ERC-20) token transfers
- —Querying merchant/recipient stats (use the merchants/{address}/stats endpoint instead)
- —Free or unauthenticated bulk data extraction
Quick start
curl -X GET \
'https://www.x402scan.com/api/x402/wallets/0xe2c87cdefbcf882901a81f8f01e96096c9bb42a1/stats?chain=base&timeframe=30' \
-H 'X-Payment: <x402_payment_token>'Endpoint
Quality
The OpenAPI spec is well-documented with clear parameter definitions and pricing, but the specific probed URL returned 404 rather than the expected 402 challenge. No response schema or example responses are provided in the spec. No dedicated docs page exists.
Warnings
- —Probe returned 404 on both GET and POST for this specific address — the endpoint may require a valid indexed address or the path may differ slightly from the listed URL.
- —No response schema is documented in the OpenAPI spec — the shape of the returned stats object is unknown.
- —No example responses are available from the probe or crawl material.
Citations
- —Endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —Supports chain filter (base, solana) and timeframe filter (1, 7, 14, 30 days)https://www.x402scan.com
- —Returns aggregate stats: tx count, total amount, unique recipientshttps://www.x402scan.com
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —The x402scan platform tracks transactions across Base and Solana chainshttps://www.x402scan.com