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 amount sent, and unique recipients for a given sender wallet. Results can be filtered by chain (Base or Solana) and by timeframe (1, 7, 14, or 30 days lookback). The endpoint is part of a broader suite of x402scan data APIs covering merchants, facilitators, resources, and full-text search.
Note: The specific URL being listed hard-codes a particular wallet address (`0xfe47d2042d788297d254e3ed3883729450e352dc`) in the path. The underlying OpenAPI spec defines this as a parameterized path `/api/x402/wallets/{address}/stats`. However, the probe returned 404 rather than the expected 402 payment challenge, which may indicate the hard-coded address is not indexed or the endpoint path format differs from the OpenAPI spec (the spec uses `/api/x402/` while the listed URL uses `/api/data/`). The endpoint costs $0.01 per call, paid via x402 micropayment in USDC.
Capabilities
Use cases
- —Retrieve aggregate spending stats for a wallet participating in x402 micropayments
- —Monitor a wallet's transaction count and volume over configurable timeframes
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption per wallet
Fit
Best for
- —Agents needing on-chain x402 payment analytics for a specific wallet
- —Developers building x402 ecosystem monitoring tools
- —Analysts tracking micropayment adoption across Base and Solana
Not for
- —General-purpose blockchain explorers (only covers x402 protocol transfers)
- —Querying non-x402 token transfers or NFT activity
- —Free/unauthenticated bulk data access (every call costs $0.01)
Quick start
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0xfe47d2042d788297d254e3ed3883729450e352dc/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameter definitions and pricing, but the specific listed endpoint URL uses /api/data/ instead of /api/x402/ and returned 404 on probe rather than the expected 402 challenge. No response schema or example responses are provided. The endpoint may be live at the /api/x402/ path variant but that was not directly probed.
Warnings
- —Probe returned 404 on both GET and POST — the listed URL path (/api/data/wallets/…) does not match the OpenAPI spec path (/api/x402/wallets/…). The endpoint may only be live at /api/x402/wallets/{address}/stats.
- —No response schema or example responses are documented in the OpenAPI spec.
- —The hard-coded wallet address in the URL may not be indexed, which could also explain the 404.
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
- —Wallet stats endpoint supports chain (base, solana) and timeframe (1, 7, 14, 30 days) query parametershttps://www.x402scan.com
- —x402scan indexes transfers on Base and Solana chainshttps://www.x402scan.com