Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol ecosystem.
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 accepts a wallet address as a path parameter and returns aggregate metrics such as transaction count, total transfer amount, and unique recipients. 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 endpoint URL in this listing contains a hardcoded wallet address (0x77579108…). The general pattern is `/api/x402/wallets/{address}/stats` where any valid wallet address can be substituted. The probe returned 404 rather than the expected 402 challenge, which may indicate the hardcoded address is not indexed or the endpoint path has been restructured. However, the OpenAPI spec documents this route as live with a matching operation (`x402_wallets_stats`), and the broader x402scan origin responds normally (HTTP 200).
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a wallet participating in x402 transfers
- —Monitor a wallet's x402 spending activity over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption per wallet
Fit
Best for
- —Agents needing on-chain x402 payment analytics per wallet
- —Developers building x402 ecosystem monitoring tools
- —Analysts tracking micropayment protocol usage
Not for
- —General-purpose blockchain explorers (covers only x402 protocol transfers, not all on-chain activity)
- —Wallets or addresses not participating in the x402 ecosystem
Quick start
curl -X GET "https://www.x402scan.com/api/x402/wallets/0x77579108449f14a3bf35931764371d0b2cfc2b44/stats?chain=base&timeframe=30" \
-H "X-Payment: <x402_payment_token>"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters, pricing, and operation IDs. However, the probe returned 404 instead of the expected 402 challenge for this specific wallet address, no response schema is provided, and no example responses are available from crawl data. Docs/pricing/README pages all return 404.
Warnings
- —Probe returned HTTP 404 on both GET and POST for this specific wallet address; the endpoint may require a wallet address that is actually indexed in x402scan's database.
- —No response schema is documented in the OpenAPI spec — only '200: Successful response' without a body definition.
- —No dedicated documentation pages found (docs, pricing, README all return 404).
Citations
- —The endpoint costs $0.01 per call 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
- —Wallet stats endpoint accepts chain (base, solana) and timeframe (1, 7, 14, 30 days) query parametershttps://www.x402scan.com
- —x402scan indexes transfers on Base and Solana chainshttps://www.x402scan.com