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, it reports metrics such as transaction count, total transfer volume, and unique recipients. The data covers x402 protocol micropayments on both Base and Solana chains. You can filter results 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 analytics dashboard built by Merit Systems. x402scan indexes on-chain x402 transfers and exposes them through a suite of paid API endpoints. This particular wallet stats endpoint costs $0.01 per request, payable via the x402 micropayment protocol. The broader API also offers merchant stats, transaction histories, facilitator analytics, resource search, and a registry for x402-protected resources.
Note: During probing, this specific URL path (which embeds a hardcoded wallet address in a `/data/wallets/` path) returned 404 on both GET and POST. However, the OpenAPI spec documents the canonical path as `/api/x402/wallets/{address}/stats`, which is the correct route. The probed URL uses `/api/data/wallets/` which appears to be a non-standard or legacy path variant. Callers should use the canonical OpenAPI path for reliable access.
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
- —Feed wallet-level metrics into dashboards or agent decision-making pipelines
- —Audit x402 micropayment volume for a given sender address
Fit
Best for
- —Agents that need to assess x402 wallet activity before transacting
- —Analytics dashboards tracking x402 protocol adoption
- —Developers building on the x402 payment protocol who need sender-side metrics
Not for
- —General-purpose blockchain explorers needing full transaction details (use the transactions endpoint instead)
- —Querying non-x402 on-chain activity or arbitrary ERC-20 transfers
- —Free/unauthenticated access — requires x402 micropayment per call
Quick start
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0xf55f9fd083f4a8e7988f99c0e688defd8c41b2b8/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameter schemas, pricing, and endpoint descriptions. However, the probed URL returned 404 (likely a path mismatch between /api/data/wallets/ and the canonical /api/x402/wallets/), no example response schema is provided, and no crawled documentation pages exist. The endpoint's liveness at the canonical path is plausible but unconfirmed by the probe.
Warnings
- —Probed URL path (/api/data/wallets/.../stats) returned 404; the canonical OpenAPI path is /api/x402/wallets/{address}/stats — the listing URL may be incorrect or outdated.
- —No response schema is documented in the OpenAPI spec; the shape of the returned stats object is unknown.
- —No dedicated documentation pages were found (docs, pricing, README all return 404).
Citations
- —Endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —Supports chain filter (base, solana) and timeframe filter (1, 7, 14, 30 days)https://www.x402scan.com
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —Canonical path is /api/x402/wallets/{address}/stats per OpenAPI spechttps://www.x402scan.com