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 (`GET /api/x402/wallets/{address}/stats`) provides summary metrics such as transaction count, total transfer amount, and unique recipients for a given sender address. Results can be filtered by chain (Base or Solana) and by timeframe (1, 7, 14, or 30 days lookback). The endpoint costs $0.01 per call, paid via an x402 micropayment in the X-Payment header.
Note: The specific URL listed here embeds a hardcoded wallet address (`0x0bb27b620e2ceb7fc5b6cc504bb80441d5c6003d`). The canonical parameterized path is `/api/x402/wallets/{address}/stats`. The probe returned 404 rather than the expected 402 challenge, which may indicate the hardcoded address is not indexed, or the endpoint routing differs from the OpenAPI spec. The broader x402scan origin is live (root returns 200) and the OpenAPI spec documents this operation clearly. x402scan also offers sibling endpoints for merchant stats, transaction history, facilitator analytics, resource search, and a USDC send function.
Capabilities
Use cases
- —Retrieve aggregate spending stats for an x402 buyer wallet
- —Monitor a wallet's transaction volume and unique recipient count over time
- —Filter wallet activity by chain (Base vs Solana) and rolling time window
- —Build dashboards tracking x402 protocol adoption per wallet
- —Audit agent spending across x402-enabled services
Fit
Best for
- —Agents that need to inspect their own x402 spending history
- —Analytics tools monitoring x402 ecosystem activity
- —Developers building wallet-level reporting on x402 transfers
Not for
- —Looking up arbitrary ERC-20 or SPL token balances outside x402 transfers
- —Querying non-USDC token activity or general blockchain data
- —Free/unauthenticated bulk data export
Quick start
curl -X GET \
'https://www.x402scan.com/api/x402/wallets/0x0bb27b620e2ceb7fc5b6cc504bb80441d5c6003d/stats?chain=base&timeframe=7' \
-H 'X-Payment: <x402_payment_token>'Endpoint
Quality
The OpenAPI spec is thorough and documents the parameterized wallet stats endpoint with clear pricing ($0.01) and query parameters. However, the specific hardcoded-address URL probed returned 404 instead of the expected 402 challenge, so liveness for this exact URL is uncertain. No response schema or example responses are provided in the spec.
Warnings
- —Probe returned 404 on both GET and POST for this specific wallet address URL; the address may not be indexed or routing may differ from the OpenAPI spec.
- —No response schema or example response documented in the OpenAPI spec.
- —No dedicated docs page found (x402scan.com/docs returns 404).
Citations
- —The endpoint is documented as GET /api/x402/wallets/{address}/stats returning aggregate stats (tx count, total amount, unique recipients) for $0.01 per call.https://www.x402scan.com
- —x402scan is described as a payment data explorer and registry for the x402 protocol, querying indexed x402 payment data on Base and Solana.https://www.x402scan.com
- —The OpenAPI spec lists chain filter (base, solana) and timeframe (1, 7, 14, 30 days) as query parameters.https://www.x402scan.com
- —x402scan is built by Merit Systems.https://www.x402scan.com