Aggregate wallet stats (tx count, volume, unique recipients) from the x402 payment ecosystem 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 `0x0bdfa61ed3871bbc9ea94884e733932e84841cf2`), it returns metrics such as transaction count, total transfer volume, and unique recipients. The data covers x402 protocol USDC transfers on Base and Solana chains.
The endpoint is part of x402scan, a payment data explorer and analytics dashboard built by Merit Systems. x402scan indexes on-chain x402 micropayment activity across multiple facilitators (Coinbase, PayAI, Meridian) and exposes it through a suite of paid API endpoints. This particular wallet stats endpoint costs $0.01 per request, payable via the x402 protocol (HTTP 402 micropayment). Optional query parameters allow filtering by chain (`base` or `solana`) and timeframe (1, 7, 14, or 30 day lookback).
Note: The probed URL uses the path `/api/data/wallets/{address}/stats` which returned 404, while the OpenAPI spec documents the canonical path as `/api/x402/wallets/{address}/stats`. The endpoint at the canonical path is expected to be live based on the broader x402scan API surface. Callers should use the `/api/x402/` path prefix.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific wallet participating in x402 micropayments
- —Monitor a wallet's x402 spending activity over configurable time windows
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participation by wallet
Fit
Best for
- —Agents that need to look up x402 payment activity for a given wallet address
- —Analytics pipelines monitoring micropayment ecosystems
- —Developers building on the x402 protocol who need wallet-level metrics
Not for
- —General-purpose blockchain explorers needing full transaction details (use the transactions endpoint instead)
- —Querying wallets outside the x402 payment ecosystem
- —Free/unauthenticated access — every call requires a $0.01 x402 micropayment
Quick start
curl -X GET "https://www.x402scan.com/api/x402/wallets/0x0bdfa61ed3871bbc9ea94884e733932e84841cf2/stats?chain=base&timeframe=7" \
-H "X-Payment: <x402_payment_token>"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameter schemas and pricing, but the specific probed URL (/api/data/...) returned 404 on both GET and POST, suggesting the listing URL is incorrect versus the canonical /api/x402/ path. No response schema or example responses are provided in the spec. No dedicated docs page exists.
Warnings
- —The probed endpoint path /api/data/wallets/{address}/stats returned 404; the OpenAPI spec documents the canonical path as /api/x402/wallets/{address}/stats — the listing URL may be incorrect.
- —No response schema is documented in the OpenAPI spec; the shape of the returned JSON is unknown.
- —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 described as 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
- —The canonical API path is /api/x402/wallets/{address}/stats per the OpenAPI spechttps://www.x402scan.com