Aggregate wallet stats (tx count, volume, unique recipients) for any x402 sender address.
What it does
This endpoint returns aggregate statistics for a given wallet address that has participated as a sender in x402 protocol transfers. It is part of x402scan, a payment data explorer and analytics platform for the x402 ecosystem built by Merit Systems. The endpoint lives at `/api/x402/wallets/{address}/stats` and accepts an address path parameter.
The stats returned include transaction count, total amount sent, and unique recipients. Optional query parameters let you filter by chain (Base or Solana) and by timeframe (1, 7, 14, or 30 day lookback). The endpoint costs $0.01 per call, paid via an x402 micropayment in the `X-Payment` header. Payment settles in USDC.
Note: the probe attempted to reach a URL containing `/api/data/wallets/…/stats` (with an extra `/data/` segment) rather than the canonical `/api/x402/wallets/{address}/stats` path documented in the OpenAPI spec, which likely explains the 404 response. The canonical path documented in the OpenAPI spec should be used instead. The broader x402scan origin returned HTTP 200 and the OpenAPI spec is fully published, so the service itself appears live.
Capabilities
Use cases
- —Retrieve aggregate spending stats for an x402 buyer wallet
- —Monitor a wallet's transaction count and volume over configurable timeframes
- —Compare wallet activity across Base and Solana chains
- —Build dashboards tracking x402 ecosystem participant behavior
- —Audit an agent wallet's cumulative x402 spend
Fit
Best for
- —Agents that need to inspect their own or others' x402 spending history
- —Analytics dashboards tracking x402 protocol adoption
- —Developers building wallet profile pages for x402 participants
Not for
- —Looking up non-x402 (general ERC-20) transfer history
- —Querying merchant/recipient-side stats (use the merchants stats endpoint instead)
- —Free or unauthenticated access — requires x402 micropayment per call
Quick start
curl -X GET \
'https://www.x402scan.com/api/x402/wallets/0x0f12e5192c0ad92106eda0c7ee6fa07ac3a4b439/stats?chain=base&timeframe=30' \
-H 'X-Payment: <x402_payment_token>'Endpoint
Quality
Full OpenAPI spec with clear pricing and parameter documentation is available, but the specific probed URL returned 404 (likely due to a path mismatch with /api/data/ vs /api/x402/). No response body examples are provided in the spec, and no dedicated docs page exists. The canonical endpoint is likely live but was not directly confirmed via 402 challenge.
Warnings
- —Probe URL contains '/api/data/wallets/' but the OpenAPI spec documents the path as '/api/x402/wallets/{address}/stats' — the probed URL likely has an incorrect path segment.
- —No example response schema is provided in the OpenAPI spec; response shape must be inferred.
- —Endpoint liveness not directly confirmed — probe returned 404, possibly due to path mismatch rather than the endpoint being down.
Citations
- —The endpoint is documented as GET /api/x402/wallets/{address}/stats with a fixed price of $0.01https://www.x402scan.com
- —x402scan is described as a payment data explorer and registry for the x402 protocol, built by Merit Systemshttps://www.x402scan.com
- —Supports chain filter (base, solana) and timeframe filter (1, 7, 14, or 30 days)https://www.x402scan.com
- —Summary: Aggregate stats for a wallet (tx count, total amount, unique recipients)https://www.x402scan.com