Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol ecosystem for $0.01 per call.
What it does
This endpoint returns aggregate statistics for a specific wallet address within the x402 payment ecosystem. Given a wallet address, it reports metrics such as transaction count, total transfer amount, and unique recipients. The data covers x402 protocol micropayments on both Base and Solana chains. Results can be filtered by chain (base or solana) and by timeframe (1, 7, 14, or 30 days lookback).
The endpoint is part of x402scan, an analytics dashboard and block explorer for the x402 protocol built by Merit Systems. x402scan indexes on-chain x402 micropayment transfers and exposes them through a suite of paid data endpoints. This particular endpoint (wallets/{address}/stats) focuses on sender-side analytics — how much a given wallet has spent, how many transactions it has made, and how many distinct recipients it has paid.
Payment is handled via the x402 protocol itself: each call costs $0.01 USD, paid as a USDC micropayment through an x402-compatible client. The endpoint is a GET request with optional query parameters for chain and timeframe filtering. Note that the specific URL probed includes a hardcoded wallet address; the general pattern is /api/x402/wallets/{address}/stats where {address} is any valid wallet address.
Capabilities
Use cases
- —Checking how much a specific wallet has spent via x402 micropayments
- —Monitoring wallet activity across Base and Solana chains over configurable time windows
- —Building dashboards that track x402 protocol adoption by analyzing sender wallets
- —Auditing agent spending by querying aggregate stats for an agent's wallet address
- —Comparing wallet activity across different timeframes (1d, 7d, 14d, 30d)
Fit
Best for
- —Agents that need to audit their own x402 spending history
- —Analytics tools tracking x402 ecosystem wallet activity
- —Developers building x402 protocol monitoring dashboards
Not for
- —General-purpose blockchain explorers needing non-x402 transaction data
- —Querying wallet balances or token holdings (this only covers x402 transfer stats)
- —Free or unauthenticated access — every call requires a $0.01 x402 micropayment
Quick start
# Fetch aggregate stats for a wallet on x402scan
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0x03bd93773f7644c52bc87954e82eb937cd77096b/stats?chain=base&timeframe=7"Endpoint
Quality
Full OpenAPI schema with clear parameter definitions and pricing metadata is available. However, the specific endpoint URL probed returned 404 (the path uses /api/data/ instead of the documented /api/x402/ prefix), no response body examples exist in the schema, and no dedicated documentation pages were found. The endpoint may be at a slightly different path than listed.
Warnings
- —Probe returned 404 on both GET and POST — the listed URL uses /api/data/wallets/... but the OpenAPI spec documents the path as /api/x402/wallets/{address}/stats. The endpoint may be live at the /api/x402/ path instead.
- —No response schema or example responses are documented in the OpenAPI spec.
- —No dedicated docs page exists (x402scan.com/docs returns 404).
Citations
- —The wallets/{address}/stats endpoint returns aggregate stats (tx count, total amount, unique recipients) and costs $0.01 per call.https://www.x402scan.com
- —x402scan is described as 'the x402 analytics dashboard and block explorer' built by Merit Systems.https://www.x402scan.com
- —Data endpoints support chain filtering (base, solana) and timeframe filtering (1, 7, 14, or 30 days).https://www.x402scan.com
- —The OpenAPI spec documents the endpoint path as /api/x402/wallets/{address}/stats, not /api/data/wallets/{address}/stats.https://www.x402scan.com