Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address.
What it does
This endpoint returns aggregate statistics for a specific wallet address acting as a sender (buyer) in the x402 payment ecosystem. Given a wallet address in the URL path, it returns metrics such as transaction count, total amount sent, and unique recipients. Results 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 analytics dashboard for the x402 protocol built by Merit Systems. x402scan indexes on-chain USDC transfers made via the x402 micropayment protocol across Base and Solana. The broader API suite includes endpoints for merchant stats, transaction histories, facilitator analytics, resource search, and a registry for x402-protected resources.
This specific endpoint costs $0.01 per call, paid via an x402 micropayment in USDC. Note: the probe returned a 404 for this endpoint, likely because the hardcoded wallet address in the listing URL (0x5af25cea8455c2a70d692d3c9002e1daac97c24c) may not exist in the index, or the URL path uses a legacy `/data/` prefix rather than the documented `/x402/` prefix. The canonical path per the OpenAPI spec is `/api/x402/wallets/{address}/stats`.
Capabilities
Use cases
- —Retrieve aggregate spending stats for a specific x402 buyer wallet
- —Monitor how much USDC a wallet has sent via x402 over a given timeframe
- —Identify unique merchants a wallet has transacted with
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 protocol adoption per wallet
Fit
Best for
- —Agents needing quick wallet-level spending summaries in the x402 ecosystem
- —Analytics dashboards monitoring x402 buyer behavior
- —Developers building on top of x402 protocol data
Not for
- —Looking up non-x402 on-chain transactions or general blockchain data
- —Querying merchant/recipient stats (use the merchants/{address}/stats endpoint instead)
- —Free or high-volume bulk data extraction (each call costs $0.01)
Quick start
curl -H "X-Payment: <x402_payment_header>" \
"https://www.x402scan.com/api/x402/wallets/0x5af25cea8455c2a70d692d3c9002e1daac97c24c/stats?chain=base&timeframe=30"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters, pricing, and operation descriptions. However, the probe returned 404 (the listing URL uses /api/data/ while the spec uses /api/x402/), no example response schema is provided, and no crawled documentation pages exist. The endpoint is likely live at the canonical path but could not be confirmed.
Warnings
- —Probe returned 404 — the listing URL path (/api/data/wallets/…/stats) does not match the OpenAPI spec path (/api/x402/wallets/…/stats). The canonical endpoint may be live at the /api/x402/ path.
- —No response schema is documented in the OpenAPI spec; the shape of the returned JSON 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
- —OpenAPI spec defines the canonical path as /api/x402/wallets/{address}/statshttps://www.x402scan.com