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 for the x402 protocol, built by Merit Systems. The wallet stats endpoint provides metrics such as transaction count, total amount sent, and unique recipients for any wallet that has participated as a sender in x402 transfers on Base or Solana.
The endpoint accepts optional query parameters to filter by chain (base or solana) and timeframe (1, 7, 14, or 30 days lookback). It is a GET request that costs $0.01 per call, paid via the x402 micropayment protocol. The specific URL listed here queries a particular wallet address (0xb0ded2871ce8d6427305de3059646ac82cb0f60e), but the pattern generalizes to any wallet address via `/api/x402/wallets/{address}/stats`.
Note: The probe returned 404 for this specific wallet address endpoint (under the path `/api/data/wallets/...`), while the OpenAPI spec documents the endpoint under `/api/x402/wallets/{address}/stats`. The URL path prefix differs (`/api/data/` vs `/api/x402/`), which likely explains the 404. The broader x402scan origin is live (root returns 200) and the OpenAPI spec is well-documented with 13+ endpoints covering wallets, merchants, facilitators, resources, and a USDC send function.
Capabilities
Use cases
- —Retrieve aggregate sending statistics for a wallet participating in x402 payments
- —Monitor wallet activity over configurable timeframes (1, 7, 14, or 30 days)
- —Filter wallet stats by blockchain (Base or Solana)
- —Build dashboards tracking x402 protocol adoption per wallet
- —Audit agent spending patterns across x402-enabled services
Fit
Best for
- —Agents that need to inspect their own x402 spending history
- —Analytics tools monitoring x402 protocol activity
- —Developers building wallet dashboards for x402 micropayments
Not for
- —General-purpose blockchain explorers (this only covers x402 protocol transfers)
- —Querying non-x402 token transfers or NFT activity
- —Free/unauthenticated access — requires $0.01 x402 micropayment per call
Quick start
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0xb0ded2871ce8d6427305de3059646ac82cb0f60e/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is thorough and clearly documents the wallet stats endpoint with parameters and pricing. However, the specific listed URL uses a different path prefix (/api/data/) than the documented one (/api/x402/), and the probe returned 404 rather than the expected 402 challenge. No response schema or example responses are provided in the spec.
Warnings
- —The listed endpoint URL uses path /api/data/wallets/... but the OpenAPI spec documents /api/x402/wallets/{address}/stats — the listed URL likely has an incorrect path prefix.
- —Probe returned 404 on both GET and POST, suggesting the exact URL as listed is not live. The correct path may be /api/x402/wallets/{address}/stats.
- —No response schema or example responses are documented in the OpenAPI spec — response shape must be inferred.
Citations
- —The wallet stats 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 endpoint supports chain filter (base, solana) and timeframe filter (1, 7, 14, or 30 days)https://www.x402scan.com
- —The OpenAPI spec documents the endpoint at /api/x402/wallets/{address}/statshttps://www.x402scan.com