Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol 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 USDC transfers on both Base and Solana chains. 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 built by Merit Systems. x402scan indexes on-chain x402 micropayment activity and exposes it through a suite of paid API endpoints. This particular endpoint (wallets/{address}/stats) costs $0.01 per request, payable via the x402 protocol with an X-Payment header. The broader x402scan API also offers endpoints for merchant stats, buyer/seller leaderboards, facilitator analytics, resource registry search, and USDC sending.
Note: The probe returned 404 for this specific URL because the endpoint path in the OpenAPI spec is `/api/x402/wallets/{address}/stats`, while the probed URL used `/api/data/wallets/{address}/stats`. The canonical endpoint path per the OpenAPI spec is `/api/x402/wallets/{address}/stats`. The OpenAPI schema is well-documented with clear parameter definitions, pricing metadata, and operational guidance, though response schemas are not detailed beyond '200: Successful response'.
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 (1, 7, 14, or 30 days)
- —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 wallet activity without paginating through individual transactions
- —Analytics pipelines monitoring x402 protocol adoption per wallet
- —Developers building x402 ecosystem dashboards or leaderboards
Not for
- —General-purpose blockchain wallet balance lookups (this only covers x402 protocol transfers)
- —Querying non-USDC token transfers or arbitrary ERC-20 activity
- —Free/unauthenticated access — every call requires a $0.01 x402 micropayment
Quick start
curl -X GET \
'https://www.x402scan.com/api/x402/wallets/0xffe6a82089db140949c999b583d49d46183c00ae/stats?chain=base&timeframe=7' \
-H 'X-Payment: <x402_payment_token>'Endpoint
Quality
The OpenAPI spec is thorough with clear parameter definitions and pricing metadata, but the probed URL returned 404 (likely a path mismatch: /api/data/ vs /api/x402/). Response schemas are absent — only '200: Successful response' is documented with no field definitions. No example responses are available from the crawl.
Warnings
- —Probe returned 404: the probed path /api/data/wallets/{address}/stats does not match the OpenAPI canonical path /api/x402/wallets/{address}/stats — the endpoint listing URL may need correction
- —Response schema is not documented; field names and structure must be inferred at runtime
- —No example response data available from crawl or probe
Citations
- —Endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —OpenAPI spec defines the path as /api/x402/wallets/{address}/stats with chain and timeframe query parametershttps://www.x402scan.com
- —x402scan is described as a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —Data endpoints require $0.01–$0.02 x402 micropaymentshttps://www.x402scan.com
- —Supports filtering by chain (base, solana) and timeframe (1, 7, 14, or 30 days)https://www.x402scan.com