Aggregate wallet stats (tx count, volume, unique recipients) for any x402 address, $0.01 per query.
What it does
This endpoint returns aggregate statistics for a given 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 specific endpoint `/api/x402/wallets/{address}/stats` accepts a wallet address as a path parameter and returns 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 probe URL embeds a specific wallet address (`0x0F12e5192C0ad92106Eda0C7Ee6FA07AC3A4B439`) but uses the path `/api/data/wallets/...` rather than the documented `/api/x402/wallets/...` path. The probe returned 404 on both GET and POST, which may indicate the URL path is outdated or incorrect. The canonical OpenAPI path is `/api/x402/wallets/{address}/stats`. The broader x402scan platform is live (root returns 200) and provides a full suite of data endpoints covering merchants, buyers, facilitators, resources, and a resource registry.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address participating in x402 transfers
- —Monitor a wallet's x402 spending activity over configurable time windows (1, 7, 14, or 30 days)
- —Filter wallet stats by chain (Base or Solana) to analyze cross-chain payment behavior
- —Build dashboards or alerts around x402 protocol wallet activity
Fit
Best for
- —Agents or applications that need on-chain x402 payment analytics per wallet
- —Developers building monitoring tools for x402 protocol participants
- —Analysts tracking micropayment volume and counterparty diversity for specific addresses
Not for
- —General-purpose blockchain explorers (this only covers x402 protocol transfers, not all on-chain activity)
- —Querying non-USDC token transfers or non-x402 transactions
- —Free or unauthenticated bulk data access (each call costs $0.01 via x402)
Quick start
# Using the canonical OpenAPI path
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0x0F12e5192C0ad92106Eda0C7Ee6FA07AC3A4B439/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is thorough with clear parameter definitions and pricing, but the probed URL returned 404 (path mismatch: /api/data/ vs /api/x402/), no response schema is documented, and no example responses are available. The root site is live and the broader platform appears healthy.
Warnings
- —Probed URL uses /api/data/wallets/ but the OpenAPI spec documents /api/x402/wallets/ — the probed path returned 404 and may be outdated or incorrect.
- —No response schema is defined in the OpenAPI spec — only '200: Successful response' with no body description.
- —No example response data is available from probe or crawl material.
Citations
- —The endpoint costs $0.01 per call in USD via x402 micropaymenthttps://www.x402scan.com
- —x402scan is described as a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —The canonical OpenAPI path is /api/x402/wallets/{address}/stats with chain and timeframe query parametershttps://www.x402scan.com
- —Supported chains are Base and Solana; timeframe options are 1, 7, 14, or 30 dayshttps://www.x402scan.com