Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address, $0.01 per call.
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 x402 micropayment transfers across Base and Solana chains and exposes them via a suite of paid data endpoints. Each data query costs $0.01–$0.02 in USDC via the x402 payment protocol. The specific wallet stats endpoint is priced at $0.01 per request.
Note: The probe returned 404 for this specific URL, which uses the path prefix `/api/data/wallets/` rather than the documented `/api/x402/wallets/` prefix found in the OpenAPI spec. The canonical endpoint path per the OpenAPI spec is `/api/x402/wallets/{address}/stats`. The 404 likely indicates the URL in the listing uses a stale or incorrect path prefix. Callers should use the `/api/x402/` prefix instead.
Capabilities
Use cases
- —Retrieve aggregate payment statistics for a specific x402 buyer wallet
- —Monitor how much a wallet has spent via x402 micropayments over a given timeframe
- —Analyze unique merchant relationships for a wallet address
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participation by wallet
Fit
Best for
- —Agents needing quick aggregate stats on x402 sender wallets
- —Analytics tools monitoring x402 protocol activity
- —Developers building wallet-level x402 spending dashboards
Not for
- —Querying non-x402 (general ERC-20/SPL) token transfers
- —Looking up wallet balances or token holdings
- —Free/unauthenticated bulk data extraction
Quick start
curl -H "X-Payment: <x402-payment-header>" \
"https://www.x402scan.com/api/x402/wallets/0xa3b59dc648397d8b13100a5cfc2e51f3f0e42b56/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters and pricing, but the actual endpoint URL in the listing uses a different path prefix (/api/data/) than the spec (/api/x402/), and the probe returned 404. No response schema or example responses are provided in the spec. The crawl yielded no dedicated docs page.
Warnings
- —The listed endpoint path /api/data/wallets/{address}/stats returned 404; the OpenAPI spec documents the path as /api/x402/wallets/{address}/stats — the listing URL may be stale or incorrect.
- —No response schema is documented in the OpenAPI spec; the shape of the returned JSON is unknown.
- —No example responses are available from probe or crawl material.
Citations
- —The endpoint returns aggregate stats for a wallet including tx count, total amount, and unique recipients, priced at $0.01https://www.x402scan.com
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —Data endpoints cost $0.01–$0.02 each via x402 micropaymenthttps://www.x402scan.com
- —Wallet stats endpoint supports chain (base, solana) and timeframe (1, 7, 14, 30) query parametershttps://www.x402scan.com