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 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 full suite includes wallet stats, merchant stats, transaction histories, facilitator analytics, resource registry, and full-text search across registered x402 resources. All data endpoints cost $0.01–$0.02 per call, paid via x402 micropayment (X-Payment header with USDC on Base or Solana).
Note: The probe returned 404 for this specific endpoint URL, which uses a path pattern `/api/data/wallets/{address}/stats` that differs from the OpenAPI-documented path `/api/x402/wallets/{address}/stats`. The OpenAPI spec documents the endpoint under `/api/x402/wallets/{address}/stats` at $0.01 per call. The listed URL may be outdated or incorrectly registered; callers should use the `/api/x402/` path prefix instead.
Capabilities
Use cases
- —Retrieve aggregate spending stats for a wallet participating in x402 micropayments
- —Monitor a wallet's x402 transaction count and total volume over configurable timeframes
- —Analyze unique recipient counts for a given sender address across Base and Solana
- —Build dashboards tracking x402 ecosystem wallet activity
Fit
Best for
- —Agents needing quick aggregate stats on x402 wallet spending behavior
- —Analytics tools monitoring the x402 micropayment ecosystem
- —Developers building x402 payment dashboards or reporting tools
Not for
- —General-purpose blockchain explorers needing non-x402 transaction data
- —Querying wallet balances or token holdings (this only covers x402 transfer stats)
- —High-frequency real-time streaming of transactions (this returns aggregates, not live feeds)
Quick start
curl -H "X-Payment: <x402_payment_token>" \
"https://www.x402scan.com/api/x402/wallets/0xdd50caf0d62c257929e3dbcc914b418c138a053e/stats?chain=base&timeframe=7"Endpoint
Quality
The OpenAPI spec is well-documented with clear parameters, pricing, and endpoint descriptions. However, the probed URL (/api/data/...) returned 404 and does not match the OpenAPI-documented path (/api/x402/...), suggesting the listed endpoint URL is incorrect. No response schema or example responses are provided in the spec.
Warnings
- —The probed endpoint URL uses /api/data/wallets/ but the OpenAPI spec documents /api/x402/wallets/ — the listed URL likely needs correction.
- —Probe returned 404 on both GET and POST for the listed URL, so this specific URL is not live.
- —No response schema or example responses are documented in the OpenAPI spec.
Citations
- —Wallet stats endpoint is documented at /api/x402/wallets/{address}/stats with $0.01 fixed pricehttps://www.x402scan.com
- —x402scan is 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 micropayment via X-Payment headerhttps://www.x402scan.com
- —Supports filtering by chain (base, solana) and timeframe (1, 7, 14, or 30 days)https://www.x402scan.com