Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address, $0.01 per call.
What it does
This endpoint returns aggregate statistics for a specific wallet address that has sent x402 payments. Given a wallet address in the URL path, it returns metrics such as transaction count, total volume, and unique recipients. 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, a payment data explorer and analytics dashboard for the x402 protocol ecosystem, built by Merit Systems. x402scan indexes on-chain USDC transfer activity across Base and Solana, tracking merchants (recipients), buyers (senders), facilitators, and registered x402 resources. The full API suite includes transaction listings, merchant stats, facilitator analytics, resource search, and a registry for x402-protected endpoints.
This specific endpoint costs $0.01 per call, paid via the x402 micropayment protocol. The probe returned a 404 rather than the expected 402 challenge, likely because the URL path contains a hardcoded wallet address that may not exist in the index, or the endpoint routing requires a valid address format. The OpenAPI spec clearly documents this endpoint at `/api/x402/wallets/{address}/stats` with a $0.01 fixed price, and the broader x402scan origin is live (HTTP 200 on root).
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific x402 buyer/sender wallet
- —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
- —Audit an agent's cumulative x402 micropayment history
Fit
Best for
- —Agents that need to inspect their own or others' x402 spending history
- —Analytics tools tracking x402 ecosystem activity
- —Developers building x402 protocol monitoring dashboards
Not for
- —Looking up arbitrary ERC-20 or SPL token transfers outside x402
- —Real-time streaming transaction feeds (this returns aggregates, not live events)
- —Wallets that have never participated in x402 payments
Quick start
curl -H "X-Payment: <x402-payment-header>" \
"https://www.x402scan.com/api/x402/wallets/0xYOUR_ADDRESS/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is thorough with clear parameter definitions and pricing, but the specific probed endpoint returned 404 instead of the expected 402 challenge (possibly due to the hardcoded test address). No response schema or example responses are documented. The root origin is live.
Warnings
- —Probe returned 404 on both GET and POST for the specific wallet address in the URL; the endpoint may require a valid indexed address to return a 402 challenge.
- —No response schema is documented in the OpenAPI spec — the shape of the returned stats object is unknown.
- —No example responses are available from docs or crawl.
Citations
- —Endpoint is documented as GET /api/x402/wallets/{address}/stats with $0.01 fixed pricehttps://www.x402scan.com
- —x402scan is described as a payment data explorer and registry for the x402 protocolhttps://www.x402scan.com
- —Supports chain filter (base, solana) and timeframe filter (1, 7, 14, 30 days)https://www.x402scan.com
- —Built by Merit Systemshttps://www.x402scan.com