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 transactions 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 costs $0.01 per call, paid via an x402 micropayment in the X-Payment header.
Note: The specific URL listed here hard-codes a particular wallet address (`0x2408a64910fc1d1055189c740bdb078961f14af4`) in the path. The probe returned 404 on both GET and POST, which may indicate this particular wallet address is not indexed, or the URL path uses a slightly different routing pattern (`/api/data/wallets/` vs the documented `/api/x402/wallets/`). The OpenAPI spec documents the canonical path as `/api/x402/wallets/{address}/stats`. Callers should use the `/api/x402/` prefix as documented.
Capabilities
Use cases
- —Retrieve aggregate spending stats for a wallet that has made x402 payments
- —Monitor transaction count and volume for a specific sender address over configurable timeframes
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participation by wallet
Fit
Best for
- —Agents needing quick wallet-level summaries of x402 payment activity
- —Analytics pipelines monitoring x402 protocol adoption
- —Developers building on the x402 ecosystem who need sender-side metrics
Not for
- —Looking up arbitrary ERC-20 or SPL token transfers outside the x402 protocol
- —Querying merchant/recipient stats (use the merchants stats endpoint instead)
- —Free or high-volume bulk data export (each call costs $0.01)
Quick start
curl -X GET \
'https://www.x402scan.com/api/x402/wallets/0x2408a64910fc1d1055189c740bdb078961f14af4/stats?chain=base&timeframe=7' \
-H 'X-Payment: <x402_payment_token>'Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters and pricing, but the specific probed URL returned 404 (path mismatch: /api/data/ vs /api/x402/), no response schema is provided, and no example responses are available. The endpoint's liveness at the exact listed URL is uncertain.
Warnings
- —Probed URL uses /api/data/wallets/ but OpenAPI documents /api/x402/wallets/ — the listed URL may be incorrect or deprecated.
- —Probe returned 404 on both GET and POST, so the exact listed endpoint could not be confirmed live.
- —No response schema or example responses are documented in the OpenAPI spec.
- —No dedicated docs page exists (x402scan.com/docs returns 404).
Citations
- —The wallet stats endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —Parameters include chain (base, solana) and timeframe (1, 7, 14, or 30 days)https://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 OpenAPI spec documents the canonical path as /api/x402/wallets/{address}/statshttps://www.x402scan.com
- —x402scan indexes transactions on Base and Solana chainshttps://www.x402scan.com