Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol explorer for $0.01 per call.
What it does
This endpoint returns aggregate statistics for a specific wallet address within the x402 payment ecosystem. Given a wallet address (in this case 0xc834c75e1fe31c479a68440389c88c996100a34c), it provides metrics such as transaction count, total transfer amount, and unique recipients. The data can be filtered by chain (Base or Solana) and by timeframe (1, 7, 14, or 30 days lookback).
The endpoint is part of x402scan, a payment data explorer and registry for the x402 protocol built by Merit Systems. x402scan indexes on-chain x402 micropayment transfers across Base and Solana, tracking merchants, buyers, facilitators, and resources. The broader API suite includes endpoints for merchant stats, facilitator analytics, resource search, and a USDC send capability.
This specific endpoint costs $0.01 per request, paid via the x402 protocol (HTTP 402 challenge with X-Payment header). Note that the probe returned 404 rather than the expected 402 challenge, which may indicate the wallet address in the URL is not indexed or the endpoint path has changed. The OpenAPI spec lists the canonical pattern as /api/x402/wallets/{address}/stats, while the probed URL uses /api/data/wallets/{address}/stats — the path prefix differs, suggesting the endpoint may have been relocated or the listing URL is stale.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet address in the x402 ecosystem
- —Monitor a wallet's x402 spending activity over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption per wallet
Fit
Best for
- —Agents needing quick wallet-level summaries of x402 micropayment activity
- —Analytics pipelines monitoring x402 protocol usage
- —Developers building on the x402 protocol who need wallet insights
Not for
- —General-purpose blockchain explorers needing full transaction details (use the transactions endpoint instead)
- —Non-x402 token transfers or arbitrary ERC-20 analytics
- —Free/unauthenticated bulk data access
Quick start
curl -H "X-Payment: <x402_payment_token>" \
"https://www.x402scan.com/api/x402/wallets/0xc834c75e1fe31c479a68440389c88c996100a34c/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters and pricing, but the probed URL (/api/data/wallets/...) returned 404 instead of 402, suggesting the listing URL is stale or uses an incorrect path prefix (the spec shows /api/x402/wallets/...). No response schema or example responses are provided in the spec. No dedicated docs pages exist.
Warnings
- —Probed endpoint returned 404 on both GET and POST — the listing URL path (/api/data/wallets/) does not match the OpenAPI spec path (/api/x402/wallets/). The correct endpoint is likely https://www.x402scan.com/api/x402/wallets/{address}/stats.
- —No response schema is documented in the OpenAPI spec; response structure must be inferred.
- —No example responses are available from the probe or documentation.
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 canonical wallet stats path is /api/x402/wallets/{address}/stats with chain and timeframe query parametershttps://www.x402scan.com
- —Supports filtering by chain (base, solana) and timeframe (1, 7, 14, or 30 days)https://www.x402scan.com