Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address.
What it does
This endpoint returns aggregate statistics for a specific wallet address acting as a sender (buyer) in the x402 payment ecosystem. It is part of x402scan, a payment data explorer and analytics platform for the x402 protocol built by Merit Systems. The endpoint is hosted at `/api/x402/wallets/{address}/stats` and accepts an Ethereum or Solana wallet address as a path parameter.
The stats returned cover transaction count, total amount sent, and unique recipients for the given wallet. Optional query parameters allow filtering 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 USDC. The specific URL listed here has the address `0x8905f8e8a9160eda9b1a9db91435db3cc2994e26` hardcoded in the path, but the same pattern works for any wallet address.
Note: The probe returned 404 for this specific address, which may indicate the address has no indexed data or the URL path uses a legacy `/api/data/` prefix rather than the documented `/api/x402/` prefix. The OpenAPI spec documents the canonical path as `/api/x402/wallets/{address}/stats`. The broader x402scan platform is live (root returns 200) and exposes a full OpenAPI 3.1.0 specification with 13 documented endpoints covering wallets, merchants, facilitators, resources, registry, and USDC send functionality.
Capabilities
Use cases
- —Retrieve aggregate spending stats for an x402 buyer wallet
- —Monitor how much USDC a wallet has spent via x402 over a given timeframe
- —Identify unique merchants a wallet has transacted with
- —Filter wallet activity by chain (Base vs Solana)
- —Build dashboards tracking x402 ecosystem participation
Fit
Best for
- —Agents needing on-chain x402 payment analytics for a specific wallet
- —Developers building x402 ecosystem monitoring tools
- —Analysts tracking x402 protocol adoption and wallet behavior
Not for
- —General-purpose blockchain explorers (this only covers x402 protocol transfers)
- —Looking up non-x402 token transfers or NFT activity
- —Free/unauthenticated bulk data access (each call costs $0.01 via x402)
Quick start
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0x8905f8e8a9160eda9b1a9db91435db3cc2994e26/stats?chain=base&timeframe=30"Endpoint
Quality
Full OpenAPI 3.1.0 schema is available with clear parameter definitions and pricing, but the specific probed URL returned 404 (possibly due to a /api/data/ vs /api/x402/ path mismatch or the address having no data). No response schema or example responses are documented. The broader platform is live.
Warnings
- —Probe returned 404 on both GET and POST — the listed URL uses /api/data/wallets/ but the OpenAPI spec documents /api/x402/wallets/. The correct canonical path is likely /api/x402/wallets/{address}/stats.
- —No response schema is documented in the OpenAPI spec — only '200: Successful response' without a body definition.
- —No example response data is available from probe or docs.
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
- —The wallets/{address}/stats endpoint returns aggregate stats (tx count, total amount, unique recipients) with optional chain and timeframe filtershttps://www.x402scan.com
- —Supported chains are Base and Solana; timeframe options are 1, 7, 14, or 30 dayshttps://www.x402scan.com
- —The x402scan platform shows 97.43K transactions and $17.06K volume in the past 24 hours across the ecosystemhttps://www.x402scan.com