Aggregate wallet stats (tx count, volume, unique recipients) from the x402 protocol ecosystem.
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 micropayment transfers on Base and Solana chains, with optional filtering by chain and 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 x402 transfers and exposes them through a suite of paid data endpoints. This particular wallet stats endpoint costs $0.01 per call, paid via the x402 micropayment protocol. Note that the probed URL uses a legacy path (`/api/data/wallets/...`) which returned 404; the canonical path documented in the OpenAPI spec is `/api/x402/wallets/{address}/stats`.
The endpoint supports two optional query parameters: `chain` (base or solana) and `timeframe` (1, 7, 14, or 30 days). No response schema is documented in the OpenAPI spec, so the exact shape of the returned JSON must be inferred from the operation summary: aggregate stats including tx count, total amount, and unique recipients.
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
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participation per wallet
- —Audit an agent's cumulative x402 micropayment expenditure
Fit
Best for
- —Developers building analytics on top of the x402 micropayment ecosystem
- —AI agents that need to inspect their own or others' x402 spending history
- —Dashboards tracking wallet-level x402 protocol activity
Not for
- —General-purpose blockchain wallet balance lookups (this only covers x402 transfers)
- —Real-time transaction streaming or webhooks
- —Querying non-USDC token transfers
Quick start
curl -H "X-Payment: <x402-payment-header>" \
"https://www.x402scan.com/api/x402/wallets/0x2b38a4bb7ce552e82d5664224bacc1c3daf1ab7d/stats?chain=base&timeframe=30"Example
Response
{
"chain": "base",
"tx_count": 142,
"timeframe": 30,
"total_amount": "14.23",
"unique_recipients": 8
}Endpoint
Quality
The OpenAPI spec documents the endpoint well with parameters and pricing, but the probed URL returned 404 (likely a legacy path mismatch vs. the canonical /api/x402/ path). No response schema is provided, so the example response is inferred from the operation summary. No dedicated docs pages exist.
Warnings
- —Probed URL path /api/data/wallets/.../stats returned 404; the canonical OpenAPI path is /api/x402/wallets/{address}/stats — the listed endpoint URL may be stale or incorrect.
- —No response schema is documented in the OpenAPI spec; the example response is inferred from the operation summary and may not match actual output.
- —No dedicated documentation pages were found (docs, pricing, README all return 404).
Citations
- —The wallet stats endpoint costs $0.01 per call via x402 micropaymenthttps://www.x402scan.com
- —Supports chain filter (base, solana) and timeframe filter (1, 7, 14, or 30 days)https://www.x402scan.com
- —Operation summary: Aggregate stats for a wallet (tx count, total amount, unique recipients)https://www.x402scan.com
- —x402scan is a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —The canonical path is /api/x402/wallets/{address}/stats per the OpenAPI spechttps://www.x402scan.com