# x402scan Wallet Aggregate Stats

> x402scan Wallet Aggregate Stats is a paid API for AI agents from x402scan-j55w7ornb-merit-systems.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns aggregate statistics for a wallet address including transaction count, total amount transacted, and unique recipients, optionally filtered by chain and timeframe.

## Facts

- Endpoint: GET https://x402scan-j55w7ornb-merit-systems.vercel.app/api/data/wallets/:address/stats
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402scan-j55w7ornb-merit-systems-vercel-app-8fdd8701
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VZs-ySU5d8iZN5-HvnDa1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402scan-j55w7ornb-merit-systems-vercel-app-8fdd8701
```

Example prompt: Give me the aggregate stats for wallet 0xABC123... on Base over the last 30 days — total transaction count, total amount, and how many unique recipients it has sent to.

## When to prefer this

Use this endpoint when you need a high-level numeric summary of a wallet's activity (tx count, volume, unique recipients) rather than paginated transaction records. Ideal for dashboards, risk scoring, or quick due-diligence checks on a wallet. Choose this over the transaction history endpoint when you don't need individual records but only aggregate rollups.

## Known failure modes

- Invalid wallet address format — returns 400 or empty result
- Unsupported chain value (not 'base' or 'solana') — returns validation error
- Unsupported timeframe value (not 1, 7, 14, or 30) — returns validation error
- Wallet with no transaction history — returns zeroed stats
- Payment not included or insufficient — returns 402 Payment Required
- Network or indexer unavailability — returns 500 or timeout

## How this service works

Aggregate stats for a wallet (tx count, total amount, unique recipients)

## Output

Returns computed aggregate metrics for the specified wallet address: total number of transactions, cumulative amount transacted, and count of unique recipient addresses, optionally scoped to a specific chain (base or solana) and a lookback window of 1, 7, 14, or 30 days.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402scan-j55w7ornb-merit-systems-vercel-app-8fdd8701/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402scan-j55w7ornb-merit-systems.vercel.app](https://www.zero.xyz/host/x402scan-j55w7ornb-merit-systems.vercel.app/llms.txt)